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

  • Artikel

Add-Ins sind seit Visual Studio 2013 veraltet. Es wird empfohlen, für Ihre Add-Ins ein Upgrade auf VSPackage-Erweiterungen durchführen. Weitere Informationen zum Durchführen eines Upgrades finden Sie unter FAQ: Konvertieren von Add-Ins in VSPackage-Erweiterungen.

Die Codebeispiele in den Referenzthemen für das Automatisierungsobjektmodell können in einem vom Add-In-Assistenten erstellten Add-In 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

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

    Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Add-Ins.

  2. Fügen Sie das Codebeispiel der Connect-Klasse des Add-Ins hinzu.

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

  4. Fügen Sie bei Visual C#-Add-Ins einen Verweis auf die System.Windows.Forms-Assembly hinzu. Öffnen Sie dazu im Projektmappen-Explorer das Kontextmenü für das Add-In-Projekt, wählen Sie Hinzufügen, Verweise aus, und wählen Sie die Schaltfläche Neuen Verweis hinzufügen aus. Wählen Sie anschließend im Dialogfeld Verweis hinzufügen 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;

  5. Kompilieren Sie das Add-In, indem Sie im Menü Erstellen die Option Projektmappe erstellen auswählen.

  6. Wählen Sie im Menü Extras den Befehl Add-In-Manager aus.

    Das Dialogfeld Add-In-Manager wird angezeigt.

  7. 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.

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Add-Ins

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

Konzepte

Add-In-Registrierung