Comment : ajouter des références aux espaces de noms Automation
Lorsque vous ajoutez une référence à EnvDTE, EnvDTE80, EnvDTE90 ou EnvDTE100, vous pouvez utiliser un assembly .NET ou une version de bibliothèque COM. Ce choix dépend de votre projet.
Si vous gérez une application ou un complément plus ancien, vous pouvez être amené à utiliser la version COM de EnvDTE, EnvDTE80, EnvDTE90 ou EnvDTE100. Si vous créez une application managée ou un complément, vous souhaiterez probablement utiliser la version de l'assembly .NET.
Lorsque vous utilisez l'Assistant Complément pour créer un complément quel que soit le langage de programmation utilisé ou lorsque vous créez une macro, le processus ajoute des références aux assemblys EnvDTE, EnvDTE90, Env90 et Env100. Dans le fichier qui contient la classe Connect, il ajoute également des directives using (en Visual Basic, imports) aux espaces de noms EnvDTE et EnvDTE80.
Pour accéder aux objets Automation en dehors des macros et des compléments créés avec l'Assistant Complément, vous devez toutefois ajouter manuellement les références d'assembly et les directives using (en Visual Basic, imports). Lorsque vous ajoutez manuellement une référence d'assembly, vous devez également affecter false à la propriété Incorporer les types interop de l'assembly. Pour ce faire, procédez comme suit :
Ajoutez la référence d'assembly. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis sélectionnez Ajouter une référence. Sous l'onglet .NET, sélectionnez l'assembly, puis cliquez sur OK. Dans un projet C#, le nom de l'assembly figure sous le nœud Références dans l'Explorateur de solutions. Dans un projet Visual Basic, le nom de l'assembly figure dans les propriétés du projet. Cliquez avec le bouton droit sur le projet dans l'Explorateur de solutions, puis sélectionnez Propriétés. Les pages de propriétés s'affichent. Sélectionnez la page Références dans le volet gauche.
Sélectionnez la référence d'assembly. Dans la fenêtre Propriétés, affectez false à la propriété Incorporer les types interop de l'assembly.
Une fois que vous disposerez de références aux espaces de noms, vous souhaiterez très probablement programmer en fonction des objets DTE et DTE2. Pour plus d'informations, consultez Comment : obtenir des références aux objets DTE et DTE2.
Notes
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Ces procédures ont été développées avec les paramètres de développement généraux actifs. Pour modifier vos paramètres, sélectionnez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.
Pour ajouter manuellement des références aux espaces de noms EnvDTE en Visual Basic ou Visual C#
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet ou sur le nœud Références, puis cliquez sur Ajouter une référence, ou cliquez sur la commande Ajouter une référence dans le menu Projet.
Dans la boîte de dialogue Ajouter une référence, cliquez sur l'onglet correspondant au type de composant souhaité ; par exemple, .NET ou COM.
Faites défiler la liste et sélectionnez EnvDTE, EnvDTE80, EnvDTE90 et EnvDTE100.
Cliquez sur OK pour ajouter deux nouvelles références au projet.
Pour activer la fonction Intellisense pour les nouveaux assemblys dans l'éditeur de code, en haut du module ou de la classe de votre projet, ajoutez un des éléments suivants :
Imports EnvDTE Imports EnvDTE80 Imports EnvDTE90 Imports EnvDTE100
using EnvDTE; using EnvDTE80; using EnvDTE90; using EnvDTE100;
Pour ajouter manuellement des références aux espaces de noms EnvDTE en Visual C++ managé
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet, puis cliquez sur Ajouter des références, ou cliquez sur la commande Ajoutez des références dans le menu Projet.
Cliquez sur Ajouter une nouvelle référence, puis sur l'onglet .NET.
Faites défiler la liste, sélectionnez EnvDTE, EnvDTE80 et EnvDTE90, puis cliquez sur Ajouter.
Cliquez sur OK pour ajouter les nouvelles références au projet.
Pour activer Intellisense pour les nouveaux assemblys dans l'éditeur de code, en haut de votre fichier projet principal, ajoutez les éléments suivants :
// Visual C++ #using <envdte.dll> #using <envdte80.dll> #using <envdte90.dll> #using <envdte100.dll>
Pour ajouter des références aux espaces de noms EnvDTE et EnvDTE80 à un code Visual C++ non managé (ATL)
Dans un fichier d'en-tête ou un fichier source approprié, ajoutez les informations suivantes :
#pragma warning( disable : 4278 ) #pragma warning( disable : 4146 ) //The following #import imports EnvDTE based on its LIBID. #import "libid:80cc9f66-e7d8-4ddd-85b6-d9e6cd0e93e2" version("8.0") lcid("0") raw_interfaces_only named_guids //The following #import imports EnvDTE80 based on its LIBID. #import "libid:1A31287A-4D7D-413e-8E32-3B374931BD89" version("8.0") lcid("0") raw_interfaces_only named_guids //The following #import imports EnvDTE90 based on its LIBID. #import "libid: 2ce2370e-d744-4936-a090-3fffe667b0e1" version("9.0") lcid("0") raw_interfaces_only named_guids //The following #import imports EnvDTE100 based on its LIBID. #import "libid: 26ad1324-4b7c-44bc-84f8-b86aed45729f" version("10.0") lcid("0") raw_interfaces_only named_guids #pragma warning( default : 4146 ) #pragma warning( default : 4278 )
Voir aussi
Tâches
Comment : contrôler des compléments avec le Gestionnaire de compléments
Procédure pas à pas : création d'un Assistant
Concepts
Graphique Modèle d'objet Automation