Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell

Artikel
08/10/2011

Die Codebeispiele in den Referenzthemen für das Automatisierungsobjektmodell können in einem vom Add-In-Assistenten erstellten Add-In ausgeführt werden. Außerdem können die Visual Basic-Codebeispiele als Makro ausgeführt werden. In den folgenden Abschnitten wird das Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell erläutert.

So führen Sie in einem Add-In ein Codebeispiel aus

Erstellen Sie mithilfe des Add-In-Assistenten ein Add-In.

Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Add-Ins.
Fügen Sie das Codebeispiel der Connect-Klasse des Add-Ins hinzu.

Rufen Sie die Codebeispielprozedur von der OnConnection-Methode des Add-Ins auf. Wenn das Codebeispiel das DTE2-Objekt als Argument benötigt, übergeben Sie die im Add-In-Code deklarierte _applicationObject-Membervariable. Der folgende Code zeigt die relevanten Abschnitte der Connect-Klasse eines Visual Basic- und Visual C#-Add-Ins:

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

Fügen Sie bei Visual C#-Add-Ins einen Verweis auf die System.Windows.Forms-Assembly hinzu. Klicken Sie dazu im Projektmappen-Explorer auf den Namen des Add-In-Projekts, wählen Sie im Menü Projekt die Option Verweis hinzufügen aus, und wählen Sie im Dialogfeld Verweis hinzufügen dann die Datei "System.Windows.Forms.dll" aus.
1. Fügen Sie bei Visual C#-Add-Ins den folgenden Code am Anfang der Datei "Connect.cs" ein:
```
using System.Windows.Forms;
```
Kompilieren Sie das Add-In, indem Sie im Menü Erstellen die Option Projektmappe erstellen auswählen.
Wählen Sie im Menü Extras den Befehl Add-In-Manager aus.

Das Dialogfeld Add-In-Manager wird angezeigt.
Laden Sie das Add-In, indem Sie im Dialogfeld Add-In-Manager das Kontrollkästchen neben dem Namen des Add-Ins aktivieren und dann auf OK klicken.

So führen Sie ein Visual Basic-Codebeispiel als Makro aus

Zeigen Sie im Menü Extras auf Makros, und klicken Sie dann auf Makro-IDE.

Die Makro-IDE wird angezeigt.
Klicken Sie in der Makro-IDE im Menü Ansicht auf Projektexplorer.
Erweitern Sie im Projektexplorer den Knoten MyMacros.
Doppelklicken Sie auf Module1.
Fügen Sie der Moduldatei das Codebeispiel hinzu.

Wenn das Codebeispiel das DTE-Objekt als Argument benötigt, erstellen Sie ein Makro ohne Parameter, das die globale DTE-Variable an das Codebeispiel übergibt. Dies wird im folgenden Code veranschaulicht:

' 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

Schließen Sie die Makro-IDE.
Zeigen Sie in der IDE von Visual Studio im Menü Extras auf Makros, und klicken Sie dann auf Makro-Explorer.

Das Fenster Makro-Explorer wird geöffnet.
Erweitern Sie in Makro-Explorer den Knoten MyMacros und dann den Knoten Module1.
Klicken Sie in Makro-Explorer mit der rechten Maustaste auf den Makronamen des Codebeispiels, und wählen Sie im Kontextmenü Ausführen aus.

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Add-Ins

Gewusst wie: Steuern von Add-Ins mit dem Add-In-Manager

Gewusst wie: Bearbeiten und programmgesteuertes Erstellen von Makros

Konzepte

Add-In-Registrierung