Freigeben über


Exemplarische Vorgehensweise: Debuggen eines Add-In-Projekts

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.

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie ein Standard-Add-In-Projekt in Visual Studio erstellt wird und Haltepunkte zum Debuggen des Projekts verwendet werden. Weitere Informationen finden Sie unter Breakpoints and Tracepoints.

Add-Ins sind kompilierte Anwendungen, die das Automatisierungsobjektmodell von Visual Studio nutzen, um die integrierte Entwicklungsumgebung (IDE) zu ändern oder zu automatisieren. Weitere Informationen finden Sie unter Erstellen von Add-Ins und Assistenten.

Hinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten.Die Elemente werden durch die verwendete Ausgabe von Visual Studio und die gewählten Einstellungen bestimmt.Weitere Informationen finden Sie unter Anpassen der Entwicklungseinstellungen in Visual Studio.

So erstellen Sie ein grundlegendes Visual Studio-Add-In-Projekt

  1. Wählen Sie in der Menüleiste Datei, Neu, Projekt aus.

    Das New Project Dialog Box wird angezeigt.

  2. Erweitern Sie im Bereich Projekttypen die Option Andere Projekttypen, und wählen Sie dann Erweiterungen aus.

  3. Wählen Sie im Bereich Vorlagen die Option Add-In für Visual Studio aus.

  4. Geben Sie im Feld Name die Zeichenfolge "SimpleAddIn" ein. Klicken Sie auf die Schaltfläche OK.

    Add-in Wizard wird gestartet.

  5. Wählen Sie auf der Seite Willkommen die Schaltfläche Weiter aus.

  6. Wählen Sie auf der Seite Wählen Sie eine Programmiersprache aus die Option Ein Add-In mit Visual C# erstellen und anschließend Weiter aus.

  7. Übernehmen Sie auf der Seite Wählen Sie einen Anwendungshost aus die Standardoptionen, und wählen Sie dann Weiter aus.

  8. Geben Sie auf der Seite Geben Sie einen Namen und eine Beschreibung ein für das Add-In den Namen "Simple Add-in" sowie die Beschreibung "Verwendet zum Veranschaulichen des Debuggens eines einfachen Add-Ins" ein. Wählen Sie Weiter aus.

  9. Aktivieren Sie auf der Seite Wählen Sie die Add-In-Optionen aus die Option Ja, ein Menüelement unter "Tools" erstellen, akzeptieren Sie die übrigen Standardeinstellungen, und wählen Sie dann Weiter aus.

  10. Aktivieren Sie auf der Seite Auswählen der Informationen unter "Info" im Hilfemenü die Option Ja, für das Add-In sollen Informationen im Dialogfeld "Info" angezeigt werden, und wählen Sie dann Weiter aus.

  11. Wählen Sie auf der Seite Zusammenfassung die Schaltfläche Fertig stellen aus.

    Der Add-In-Assistent generiert das neue Add-In-Projekt und öffnet die Datei "Connect.cs". Dies ist die Hauptklasse, die den Code für das Add-In enthält.

  12. Wählen Sie im Projektmappen-Explorer im Kontextmenü des Projekts Hinzufügen, Verweise und dann die Schaltfläche Neuen Verweis hinzufügen aus.

    Dadurch wird die Verwendung von Typen im System.Windows.Forms-Namespace ermöglicht.

    Das Dialogfeld Add Reference wird angezeigt.

  13. Wählen Sie auf der Registerkarte .NET die Option "System.Windows.Forms.dll" und dann die Schaltfläche OK aus.

    Im Projektmappen-Explorer wird ein Verweis auf den System.Windows.Forms-Namespace unter dem Knoten Verweise angezeigt.

    Dieser Namespace enthält den Code, der zur Anzeige eines Meldungsfelds erforderlich ist. Dieses Feld wird im folgenden Codebeispiel verwendet.

  14. Fügen Sie in Connect.cs die folgende Anweisung oben im Bereich SimpleAddIn hinzu, um die Verwendung eines MessageBox-Objekts zu vereinfachen:

    using System.Windows.Forms;
    
  15. Fügen Sie dem Add-In ein MessageBox-Objekt hinzu, indem Sie MessageBox.Show("Debugging a Simple Add-in"); zur Exec-Methode hinzufügen:

    public void Exec(string commandName,
       vsCommandExecOption executeOption,
       ref object varIn, ref object varOut, ref bool handled)
    {
       handled = false;
       if(executeOption ==
          vsCommandExecOption.vsCommandExecOptionDoDefault)
       {
          if(commandName == "MyAddin1.Connect.MyAddin1")
          {
             handled = true;
             MessageBox.Show("Debugging a Simple Add-in");
             return;
          }
       }
    }
    
  16. Wählen Sie die Schaltfläche Alle speichern aus, um die Arbeit zu speichern.

So debuggen Sie das Visual Studio-Add-In-Projekt

  1. Klicken Sie in Connect.cs neben der folgenden Anweisung auf den linken Rand:

    MessageBox.Show("Debugging a Simple Add-in")
    

    Ein roter Punkt (Symbol für einen Haltepunkt) wird angezeigt, und der Text in dieser Zeile wird rot hervorgehoben.

  2. Klicken Sie in der Menüleiste auf Debuggen und dann auf Debuggen starten.

    Die aktuelle Visual Studio-Sitzung (die Debugsitzung) verliert den Fokus, und das zu debuggende Programm wird in einer anderen Instanz von Visual Studio geöffnet.

  3. Wählen Sie in der Menüleiste in der Debuginstanz von Visual Studio die Option Tools, SimpleAddIn aus, um das Add-In auszuführen.

    Dadurch gelangen Sie zum Haltepunkt, den Sie festgelegt haben.

  4. Wählen Sie in der Menüleiste in der Debuginstanz Debuggen, Einzelschritt aus.

    Der Fokus wechselt wieder zum gedebuggten Programm. Das Meldungsfeld wird geöffnet, und die Meldung gibt an, dass das Add-In ausgeführt wurde.

  5. Wählen Sie die Schaltfläche OK aus, um das Meldungsfeld zu schließen.

  6. Wählen Sie in der Menüleiste in der Debuginstanz Debuggen, Fortsetzen aus.

    Schließen Sie die Debuginstanz von Visual Studio.

  7. Entfernen Sie in Connect.cs den Haltepunkt neben der MessageBox-Anweisung.

Siehe auch

Weitere Ressourcen

Erstellen von Add-Ins und Assistenten

Referenz zur Automatisierung und Erweiterbarkeit