Procédure : créer des wrappers COM

2023-05-10

Vous pouvez créer des wrappers COM (Component Object Model) à l’aide des fonctionnalités Visual Studio ou des outils .NET Framework Tlbimp.exe et Regasm.exe. Ces deux méthodes génèrent deux types de wrappers COM :

un wrapper RCW (Runtime Callable Wrapper) d’une bibliothèque de types pour exécuter un objet COM en code managé ;
un wrapper CCW (COM Callable Wrapper) avec les paramètres de Registre requis pour exécuter un objet managé dans une application native.

Dans Visual Studio, vous pouvez ajouter le wrapper COM à votre projet en tant que référence.

Encapsuler des objets COM dans une application managée

Pour créer un wrapper RCW à 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 ou une directive Using pour C#.

Remarque

Si vous souhaitez programmer des composants Microsoft Office, installez d’abord les assemblys Primary Interop Assembly Redistribuables de Microsoft Office à partir du Centre de téléchargement Microsoft.

Pour créer un wrapper RCW à l’aide des outils .NET Framework

Exécutez l’outil Tlbimp.exe (importateur de bibliothèques de types).

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.

Encapsuler des objets managés dans une application native

Pour créer un wrapper CCW à l’aide de Visual Studio

Créez un projet de bibliothèque de classes pour la classe managée que vous souhaitez exécuter en code natif. La classe doit avoir un constructeur sans paramètre.

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 assurer le contrôle de version dans le Registre Windows. Pour plus d’informations sur les numéros de version, consultez Contrôle de version des assemblys.
Dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l’onglet Compiler.
Cochez la case Inscrire pour COM Interop.

Quand 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, vous pouvez utiliser l’assembly en cliquant sur Ajouter une référence dans le menu Projet.

Pour créer un wrapper CCW à l’aide des outils .NET Framework

Exécutez l’outil Regasm.exe (outil d’inscription d’assemblys).

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 en toute transparence. 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 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.

Partager via