Comment : compiler et exécuter les exemples de code du modèle objet Automation

Les exemples de code présents dans les rubriques de référence du modèle objet Automation sont conçus pour s'exécuter dans un complément créé par l'Assistant Complément. En outre, les exemples de code Visual Basic peuvent s'exécuter sous forme de macro. Les sections suivantes expliquent comment compiler et exécuter les exemples de code du modèle objet Automation.

Pour exécuter un exemple de code dans un complément

1. Créez un complément en utilisant l'Assistant Complément.

   Pour plus d'informations, consultez Comment : créer un complément.

2. Ajoutez l'exemple de code à la classe Connect du complément.

3. Appelez la procédure de l'exemple de code depuis la méthode OnConnection du complément. Si l'exemple de code requiert l'objet DTE2 en tant qu'argument, passez la variable membre _applicationObject déclarée dans le code du complément. Le code suivant affiche les parties pertinentes de la classe Connect à partir de compléments Visual Basic et Visual C# :

   Public Sub OnConnection(ByVal application As Object, ... ) _
     Implements IDTExtensibility2.OnConnection
   
       _applicationObject = CType(application, EnvDTE80.DTE2)
           .
           .
           .
       ' Pass the _applicationObject member variable to the code 
       ' example.
       MyCodeExample(_applicationObject)
   End Sub
   ' Other methods in the Connect class.
       .
       .
       .
   
   ' This is the code example that was added to the Connect class.
   Sub MyCodeExample(ByVal dte As DTE2)
       .
       .
       .
   End Sub
   

   public void OnConnection(object application, ... , ref Array custom)
   {
       _applicationObject = (DTE2)application;
           .
           .
           .
       // Pass the _applicationObject member variable to the code 
       // example.
       MyCodeExample(_applicationObject);
   }
   
   
   // Other methods in the Connect class.
       .
       .
       .
   
   // This is the code example that was added to the Connect class.
   void MyCodeExample(DTE2 dte)
   {
       .
       .
       .
   }
   

4. Dans le cas des compléments Visual C#, ajoutez une référence à l'assembly System.Windows.Forms. Pour ce faire, cliquez sur le nom du projet de complément dans l'Explorateur de solutions, sélectionnez Ajouter une référence dans le menu Projet et choisissez System.Windows.Forms.dll dans la boîte de dialogue Ajouter une référence.

   1. Pour les compléments Visual C#, insérez le code suivant au début du fichier Connect.cs :

      using System.Windows.Forms;
      

5. Compilez le complément en sélectionnant Générer la solution dans le menu Générer.

6. Sélectionnez Gestionnaire de compléments dans le menu Outils.

   La boîte de dialogue Gestionnaire de compléments s'affiche.

7. Chargez le complément en activant la case à cocher placée en regard du nom du complément dans la boîte de dialogue Gestionnaire de compléments, puis cliquez sur OK.

Pour exécuter un exemple de code Visual Basic en tant que macro

1. Dans le menu Outils, pointez sur Macros, puis cliquez sur Éditeur de macros.

   L'Éditeur de macros s'affiche.

2. Dans le menu Affichage de l'Éditeur de macros, cliquez sur Explorateur de projets.

3. Développez le nœud MyMacros dans l'Explorateur de projets.

4. Double-cliquez sur Module1.

5. Ajoutez l'exemple de code au fichier de module.

6. Si l'exemple de code requiert l'objet DTE sous forme d'argument, créez une macro sans paramètres qui passe la variable DTE globale à l'exemple de code. L'exemple de code suivant montre comment procéder :

   ' Visual Basic
   ' Macro without parameters that calls the code example.
   Sub CodeExample()
       CodeExample(DTE)
   End Sub
   
   ' Original code example.
   Sub CodeExample(ByVal dte As DTE2)
       .
       .
       .
   End Sub
   

7. Fermez l'Éditeur de macros.

8. Dans le menu Outils de l'IDE Visual Studio, pointez sur Macros, puis cliquez sur Explorateur de macros.

   La fenêtre Explorateur de macros s'affiche.

9. Dans l'Explorateur de macros, développez le nœud MyMacros, puis développez le nœud Module1.

10. Dans l'Explorateur de macros, cliquez avec le bouton droit sur le nom de la macro de l'exemple de code, puis sélectionnez Exécuter dans le menu contextuel.

Voir aussi

Tâches

Comment : créer un complément

Comment : contrôler des compléments avec le Gestionnaire de compléments

Comment : modifier et créer des macros par programmation

Concepts

Inscription d'un complément