Comment : créer des wrappers COM
Vous pouvez créer des wrappers COM (Component Object Model) à l'aide des fonctionnalités Microsoft Visual Studio 2005 ou des outils .NET Framework Tlbimp.exe et Regasm.exe. Ces deux méthodes génèrent deux types de wrappers COM :
un Wrapper pouvant être appelé par le runtime d'une bibliothèque de types pour exécuter un objet COM en code managé ;
un Wrapper pouvant être appelé par COM avec les paramètres de Registre requis pour exécuter un objet managé dans une application native.
Dans Visual Studio 2005, vous pouvez ajouter le wrapper COM à votre projet en tant que référence.
Encapsulation d'objets COM dans une application managée
Pour créer un wrapper RCW (Runtime Callable Wrapper) à l'aide de Visual Studio
Ouvrez le projet pour votre application managée.
Dans le menu Projet, cliquez sur Afficher tous les fichiers.
Dans le menu Projet, cliquez sur Ajouter une référence.
Dans la boîte de dialogue Ajouter une référence, cliquez sur l'onglet COM, sélectionnez le composant que vous souhaitez utiliser et cliquez sur OK.
Dans l'Explorateur de solutions, notez que le composant COM est ajouté au dossier Références dans votre projet.
Vous pouvez maintenant écrire le code pour accéder à l'objet COM. Vous pouvez commencer par déclarer l'objet, par exemple avec une instruction Imports pour Visual Basic 2005 ou une instruction Using pour Visual C# 2005.
.gif "Remarque") Remarque |
|---|
Si vous souhaitez programmer des composants Microsoft Office, installez d'abord les assemblys PIA (Primary Interop Assembly) de Microsoft Office à partir du Centre de téléchargement Microsoft.À l'étape 4, sélectionnez la version la plus récente de la bibliothèque d'objets disponible pour le produit Office que vous souhaitez, comme la Bibliothèque d'objets Microsoft Word 11.0 par exemple.Microsoft Excel Technology Sample |
Pour créer un wrapper RCW (Runtime Callable Wrapper) à l'aide d'outils .NET Framework
- Exécutez l'outil Tlbimp.exe (Type Library Importer).
Cet outil crée un assembly qui contient des métadonnées de runtime pour les types définis dans la bibliothèque de types d'origine.
Encapsulation d'objets managés dans une application native
Pour créer un wrapper CCW (COM Callable Wrapper) à l'aide de Visual Studio
Créez un projet Bibliothèque de classes pour la classe managée que vous souhaitez exécuter en code natif. La classe doit avoir un constructeur par défaut.
Vérifiez que vous disposez d'un numéro de version à quatre parties complet pour votre assembly dans le fichier AssemblyInfo. Ce numéro est requis pour conserver le versioning dans le Registre Windows. Pour plus d'informations sur les numéros de version, consultez Versioning des assemblys.
Dans le menu Projet, cliquez sur Propriétés.
Cliquez sur l'onglet Compiler.
Activez la case à cocher Inscrire pour COM Interop.
Lorsque vous générez le projet, l'assembly est automatiquement inscrit pour COM Interop. Si vous générez une application native dans Visual Studio 2005, vous pouvez utiliser l'assembly en cliquant sur Ajouter une référence dans le menu Projet.
Pour créer un wrapper CCW (COM Callable Wrapper) à l'aide d'outils .NET Framework
- Exécutez l'outil Regasm.exe (outil Assembly Registration Tool).
Cet outil lit les métadonnées de l'assembly et ajoute les entrées nécessaires au Registre. Par conséquent, les clients COM peuvent créer des classes .NET Framework de manière transparente. Vous pouvez utiliser l'assembly comme s'il s'agissait d'une classe COM native.
Vous pouvez exécuter Regasm.exe sur un assembly situé dans n'importe quel répertoire, puis exécuter l'Gacutil.exe (outil Global Assembly Cache) pour le déplacer dans le Global Assembly Cache. Le déplacement de l'assembly n'invalide pas les entrées du Registre d'emplacement, car le Global Assembly Cache est toujours examiné si l'assembly est introuvable ailleurs.