Exemplarische Vorgehensweise: Debuggen eines Add-In-Projekts
In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie ein einfaches Add-In-Projekt in Visual Studio erstellt und Haltepunkte zum Debuggen des Projekts verwendet werden. Weitere Informationen finden Sie unter Haltepunkte und Ablaufverfolgungspunkte.
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.
Tipp
Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Bei der Entwicklung dieser Verfahren war die Option Allgemeine Entwicklungseinstellungen aktiviert. Wählen Sie im Menü Extras die Option Einstellungen importieren und exportieren aus, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.
So erstellen Sie ein einfaches Visual Studio-Add-In-Projekt
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Das New Project Dialog Box wird angezeigt.
Erweitern Sie im Bereich Projekttypen die Option Andere Projekttypen, und wählen Sie dann Erweiterungen aus.
Klicken Sie im Bereich Vorlagen auf Add-In für Visual Studio.
Geben Sie im Feld Name den Namen SimpleAddIn für das Add-In-Projekt ein. Klicken Sie auf OK.
Welcome to the Add-In Wizard, Visual Studio Add-In Wizard wird gestartet.
Klicken Sie auf der Seite Willkommen auf Weiter.
Wählen Sie auf der Seite Wählen Sie eine Programmiersprache die Option Ein Add-in mit Visual C# erstellen, und klicken Sie auf Weiter.
Übernehmen Sie auf der Seite Wählen Sie einen Anwendungshost aus die Standardoptionen, und klicken Sie auf Weiter.
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. Klicken Sie auf Next.
Aktivieren Sie auf der Seite Wählen Sie die Add-In-Optionen aus die Option Ja, ein Menüelement unter "Extras" erstellen. Übernehmen Sie die übrigen Standardeinstellungen. Klicken Sie auf Weiter.
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 klicken Sie auf Weiter.
Klicken Sie auf der Seite Zusammenfassung auf Fertig stellen.
Der Add-In-Assistent generiert das neue Add-In-Projekt und öffnet die IDE, wobei die Datei Connect.cs den Fokus erhält. Dies ist die Hauptklasse, die den Code für das Add-In enthält.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise, und wählen Sie dann Verweis hinzufügen, um der Assembly einen Verweis hinzuzufügen.
Dadurch wird die Verwendung von Typen im System.Windows.Forms-Namespace ermöglicht.
Das Add Reference Dialog Box wird angezeigt.
Doppelklicken Sie auf der Registerkarte .NET auf die Komponente System.Windows.Forms.dll.
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.
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;Fügen Sie dem Add-In ein MessageBox-Objekt hinzu, indem SieMessageBox.Show("Debugging a Simple Add-in"); zur Exec-Methode in Connect.cs 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; } } }Klicken Sie auf die Schaltfläche Alle speichern, um die Arbeit zu speichern.
So debuggen Sie das Visual Studio-Add-In-Projekt
Klicken Sie in Connect.cs neben der folgenden Anweisung auf den linken Rand:
MessageBox.Show("Debugging a Simple Add-in")Ein roter Punkt (Haltepunkt) wird angezeigt, und der Text in dieser Zeile wird rot hervorgehoben.
Klicken Sie im Menü Debuggen 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.
Klicken Sie in der Visual Studio-IDE, die gedebuggt wird, auf das Menü Extras.
SimpleAddIn wird unter den Menüelementen an oberster Position angezeigt.
Wählen Sie den Befehl SimpleAddIn aus, um das Add-In auszuführen.
Auf diese Weise gelangen Sie zu der Zeile, in der Sie den Haltepunkt in der Visual Studio-Debugsitzung gesetzt haben. Die Zeile ist gelb hervorgehoben.
Wählen Sie in der Debugsitzung im Menü Debuggen die Option Einzelschritt.
Der Fokus wechselt wieder zum gedebuggten Programm. Das Meldungsfeld wird geöffnet, und die Meldung gibt an, dass das Add-In ausgeführt wurde.
Klicken Sie auf OK, um das Meldungsfeld zu schließen.
Wählen Sie in der Debugsitzung im Menü Debuggen die Option Weiter.
Die gedebuggte Visual Studio-Sitzung erhält wieder den Fokus.
Beenden Sie die gedebuggte Visual Studio-Sitzung.
Klicken Sie in Connect.cs auf den Haltepunkt neben der MessageBox-Anweisung, um ihn aus dem Quellcode zu entfernen.
Wie Sie sehen, wird beim Debuggen eines Add-Ins eine andere Instanz der Visual Studio-IDE geöffnet, in der das aktive Add-In gehostet wird. In der ersten Instanz wird der Code angezeigt, den Sie debuggen können, indem Sie Überwachungsvariablen, Haltepunkte usw. festlegen. Nachdem Sie den Debugvorgang beendet haben, wird die zweite Instanz der IDE geschlossen, und Sie kehren zum Code des Add-Ins in der ersten Instanz zurück.