Aspose.PDF for .NET via COM Interop

Travailler avec COM Interop

Aspose.PDF for .NET s’exécute sous le contrôle du .NET Framework et cela s’appelle du code géré. Le code écrit dans tous les langages ci-dessus s’exécute en dehors du .NET Framework et cela s’appelle du code non géré. L’interaction entre le code non géré et Aspose.PDF se produit via la fonctionnalité .NET appelée COM Interop.

Les objets Aspose.PDF sont des objets .NET, mais lorsqu’ils sont utilisés via COM Interop, ils apparaissent comme des objets COM dans votre langage de programmation. Par conséquent, il est préférable de s’assurer que vous savez comment créer et utiliser des objets COM dans votre langage de programmation, avant de commencer à utiliser Aspose.PDF for .NET.

Voici les sujets que vous devrez éventuellement maîtriser :

Enregistrer Aspose.PDF for .NET avec COM Interop

Vous devez installer Aspose.PDF for .NET et vous assurer qu’il est enregistré avec COM Interop (en vous assurant qu’il peut être appelé depuis du code non géré).

Attention, /codebase est nécessaire uniquement si Aspose.PDF.dll n’est pas dans le GAC, l’utilisation de cette option fait que regasm met le chemin de l’assembly dans le registre.

ProgIDs

ProgID signifie “identifiant programmatique”. C’est le nom d’une classe COM utilisée pour créer un objet. Les ProgIDs se composent du nom de la bibliothèque “Aspose.PDF” et du nom de la classe.

Bibliothèque de types

Création d’objets COM

La création d’un objet COM est similaire à la création d’un objet .NET normal :

'Instantiate Pdf instance by calling its empty constructor
Dim document
Set document = CreateObject("Aspose.Pdf.Document")

Une fois créé, vous pouvez accéder aux méthodes et propriétés de l’objet, comme s’il s’agissait d’un objet COM :

'Add page to the document
document.Pages.Add()

Certaines méthodes ont des surcharges et elles seront exposées par COM Interop avec un suffixe numérique ajouté, sauf pour la toute première méthode qui reste inchangée. Par exemple, les surcharges de la méthode Document.Save deviennent Document.Save, Document.Save_2, et ainsi de suite.

Pour plus d’informations, consultez les articles spécifiques au langage plus loin dans cette documentation.

Création d’une assembly wrapper

Si vous devez utiliser de nombreuses classes, méthodes et propriétés de Aspose.PDF for .NET, envisagez de créer une assembly wrapper (en utilisant C# ou tout autre langage de programmation .NET). Les assemblies wrapper aident à éviter d’utiliser Aspose.PDF for .NET directement depuis du code non géré.

Une bonne approche consiste à développer une assembly .NET qui référence Aspose.PDF for .NET et fait tout le travail avec, et n’expose qu’un ensemble minimal de classes et de méthodes au code non géré. Votre application devrait alors fonctionner uniquement avec votre bibliothèque wrapper.

Réduire le nombre de classes et de méthodes que vous devez invoquer via COM Interop simplifie le projet. Utiliser des classes .NET via COM Interop nécessite souvent des compétences avancées.