Partager via


Empaquetage d'un assembly pour COM

Les développeurs COM peuvent bénéficier des informations suivantes sur les types managés qu'ils prévoient d'incorporer dans leur application :

  • une liste des types pouvant être consommés par des applications COM ;

    Certains types managés sont rendus invisibles à COM, d'autres sont visibles mais ne peuvent pas être créés et d'autres enfin sont visibles et peuvent être créés. Un assembly peut comprendre une combinaison quelconque de types invisibles, visibles, ne pouvant pas être créés et pouvant être créés. À des fins de précision, identifiez les types figurant dans un assembly que vous avez l'intention d'exposer à COM, spécialement lorsque ces types constituent un sous-ensemble de types exposés au .NET Framework.

    Pour plus d'informations, consultez Qualification des types .NET en vue d'une interopérabilité.

  • des instructions de versioning ;

    Les classes managées qui implémentent l'interface de classe (une interface générée par COM Interop) sont soumises à des restrictions de versioning.

    Pour obtenir des indications sur l'utilisation de l'interface de classe, consultez Présentation de l'interface de classe.

  • des instructions de déploiement ;

    Les assemblys avec nom fort signés par un éditeur peuvent être installés dans le Global Assembly Cache. Les assemblys non signés doivent être installés sur l'ordinateur de l'utilisateur en tant qu'assemblys privés.

    Pour plus d'informations, consultez Aspects de la sécurité des assemblys.

  • l'inclusion d'une bibliothèque de types.

    La plupart des types nécessitent une bibliothèque de types lorsqu'ils sont consommés par une application COM. Vous pouvez générer une bibliothèque de types ou confier cette tâche aux développeurs COM. Le Kit de développement logiciel (SDK) Windows propose les options suivantes pour générer une bibliothèque de types :

    • Outil Type Library Exporter

    • TypeLibConverter, classe

    • Outil Assembly Registration Tool

    • Outil .NET Services Installation Tool

    Quel que soit le mécanisme que vous choisissez, seuls les types publics définis dans l'assembly que vous fournissez sont inclus dans la bibliothèque de types générée.

    Vous pouvez empaqueter une bibliothèque de types sous la forme d'un fichier séparé ou l'incorporer en tant que fichier de ressources Win32 dans une application .NET. Microsoft Visual Basic 6.0 effectuait cette tâche pour vous automatiquement ; toutefois, lorsque vous utilisez Microsoft Visual Basic 2005, vous devez incorporer votre bibliothèque de types manuellement. Pour obtenir des instructions, consultez Comment : incorporer des bibliothèques de types comme des ressources Win32 dans les applications .NET.

Outil Type Library Exporter

L'outil de ligne de commande Type Library Exporter (Tlbexp.exe) permet de convertir les classes et les interfaces figurant dans un assembly en bibliothèque de types COM. Une fois les informations sur les types de la classe disponibles, les clients COM peuvent créer une instance de la classe .NET et appeler les méthodes de l'instance, comme s'il s'agissait d'un objet COM. Tlbexp.exe convertit l'intégralité d'un assembly en une seule opération. Vous ne pouvez pas utiliser Tlbexp.exe pour générer des informations sur les types pour un sous-ensemble de types définis dans un assembly.

TypeLibConverter, classe

La classe TypeLibConverter située dans l'espace de noms System.Runtime.Interop, convertit les classes et les interfaces figurant dans un assembly en une bibliothèque de types COM. Cette interface API produit les mêmes informations sur les types que l'outil Type Library Exporter décrit dans la section précédente.

La classe TypeLibConverter implémente l'interface ITypeLibConverter.

Outil Assembly Registration Tool

L'outil Assembly Registration Tool (Regasm.exe) peut générer et inscrire une bibliothèque de types lorsque vous appliquez l'option /tlb:. Les clients COM exigent que les bibliothèques de types soient installées dans la base de registres Windows. Sans cette option, Regasm.exe n'inscrit que les types dans un assembly et non la bibliothèque de types. L'inscription des types dans un assembly et l'inscription de la bibliothèque de types sont deux activités distinctes.

Outil .NET Services Installation Tool

L'outil .NET Services Installation Tool (Regsvcs.exe) ajoute des classes managées aux Services de composants Windows 2000 et combine plusieurs tâches dans un seul outil. Outre le chargement et l'inscription d'un assembly, Regsvcs.exe peut générer, inscrire et installer la bibliothèque de types dans une application COM+ 1.0 existante.

Voir aussi

Tâches

Comment : incorporer des bibliothèques de types comme des ressources Win32 dans les applications .NET

Référence

Tlbexp.exe (exportateur de bibliothèques de types)

TypeLibConverter

ITypeLibConverter

Concepts

Exposition de composants .NET Framework à COM

Qualification des types .NET en vue d'une interopérabilité

Présentation de l'interface de classe

Aspects de la sécurité des assemblys

Inscription d'assemblys dans COM