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

Article
08/21/2008

Mise à jour : novembre 2007

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. De plus, 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

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

Pour plus d'informations, consultez Comment : créer un complément.
Ajoutez l'exemple de code à la classe Connect du complément.

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)
{
    .
    .
    .
}

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, puis le fichier 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;
```
Compilez le complément en sélectionnant Générer la solution dans le menu Générer.
Sélectionnez Gestionnaire de compléments dans le menu Outils.

La boîte de dialogue Gestionnaire de compléments s'affiche.
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

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

L'Éditeur de macros s'affiche.
Dans le menu Affichage de l'Éditeur de macros, cliquez sur Explorateur de projets.
Développez le nœud MyMacros dans l'Explorateur de projets.
Double-cliquez sur Module1.
Ajoutez l'exemple de code au fichier de module.

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(DTE2)
End Sub

' Original code example.
Sub CodeExample(ByVal dte As DTE2)
    .
    .
    .
End Sub

Fermez l'Éditeur de macros.
Dans le menu Outils de Visual Studio, pointez sur Macros, puis cliquez sur Explorateur de macros.

La fenêtre Explorateur de macros s'affiche.
Dans l'Explorateur de macros, développez le nœud MyMacros, puis développez le nœud Module1.
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.

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

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

Voir aussi

Tâches

Concepts

Ressources supplémentaires