Überblick

Die Erweiterung "VisualStudio.Extensibility Diagnostics Explorer" wurde entwickelt, um visualStudio.Extensibility-Erweiterungen beim Entwickeln zu debuggen. Die Zielgruppe für diese Erweiterung ist Erweiterungsautoren, nicht Erweiterungskunden. Diese Erweiterung bietet eine Schnittstelle zum Überprüfen der Erweiterbarkeitspunkte, mit denen Erweiterungen interagieren, und welche Konfigurationsobjekterweiterungen für die IDE bereitgestellt werden, und die Metadaten dieser Konfigurationsobjekte.

Loslegen

Befolgen Sie diese Anweisungen, um den Diagsnotics-Explorer zu installieren, zu starten und zu konfigurieren.

Installieren der Erweiterung

Sie können den Diagnose-Explorer entweder direkt über den Erweiterungs-Manager in Visual Studio oder über den Visual Studio Marketplace hierabrufen.

Öffnen des Diagnose-Explorers in Visual Studio

Um den Diagnose-Explorer in Visual Studio zu starten, wählen Sie VisualStudio.Extensibility Diagnostics Explorer im Menü Erweiterungen aus.

Aktivieren der Sammlung von Diagnosen

Der Diagnose-Explorer ist so konfiguriert, dass relevante Diagnosedaten standardmäßig aus Ihren Erweiterungen gesammelt werden. Wenn Sie diese Datensammlung deaktivieren oder erneut aktivieren möchten, können Sie das Kontrollkästchen Sammeln von Diagnosedaten aktivieren in der unteren linken Ecke des Toolfensters umschalten. Ein Neustart von Visual Studio ist erforderlich, damit änderungen an dieser Einstellung wirksam werden.

Diagnoseseiten

Der linke Bereich des Toolfensters „Diagnose-Explorer“ enthält eine Liste verschiedener Diagnoseseiten. Es gibt zwei Arten von Diagnoseseiten: erweiterbare Features und Erweiterbarkeitsinfrastruktur. Erweiterbare Featureseiten stellen Diagnoseinformationen zu einer bestimmten erweiterbaren Komponente in Visual Studio bereit, z. B. Befehle. Erweiterungsinfrastrukturseiten liefern Diagnoseinformationen, die unabhängig davon relevant sind, in welche Erweiterungspunkte Ihre Erweiterung integriert ist. Die -Seite "Ereignisse", ein Live-Viewer für Erweiterbarkeitsereignisse und die Clientkontexte Seite, die den relevanten IDE-Zustand anzeigt, um Ihre Aktivierungseinschränkungen zu erstellen, sind die beiden Erweiterungsinfrastrukturseiten.

Erweiterbare Featureseiten

Erweiterbare Featureseiten haben oben links ein Dropdownmenü für die verschiedenen Erweiterbarkeitspunkte in diesem Featurebereich, von denen jeder direkt den Konfigurationsobjekten in der Erweiterung zugeordnet werden kann. Beispielsweise gibt es auf der Seite Befehle einen Erweiterbarkeitspunkt für Menüs und Symbolleisten, der Ihnen alle Menüs und Symbolleisten zeigt, die Visual Studio in Ihren VisualStudio.Extensibility-Erweiterungen gefunden hat.

Die Daten werden in Echtzeit aktualisiert, da Eigenschaften in Erweiterungen aktualisiert werden. Wenn beispielsweise eine Erweiterung den Anzeigenamen eines seiner Befehle zur Laufzeit ändert, wird der neue Anzeigename dieses Befehls in der Zelle in der Anzeigename Spalte für diesen Befehl sofort angezeigt.

Der Erweiterbarkeitspunkt ComboBox verfügt auch über ein Element namens Log, das Ihnen eine Liveansicht dieser Updates anzeigt. Die Schaltfläche Alle löschen neben der ComboBox kann verwendet werden, um alle aktuell angezeigten Zeilen in der Ansicht zu löschen.

Sie können die Elemente in der Ansicht mithilfe der Erweiterungen ComboBox filtern. Wenn Alle in diesem Kombinationsfeld ausgewählt ist, werden die Daten jeder installierten VisualStudio.Extensibility-Erweiterung angezeigt. Wenn Sie dieses Kombinationsfeld auf die ID einer spezifischen Erweiterung ändern, werden nur Elemente angezeigt, die sich auf diese spezifische Erweiterung beziehen. Der Wert dieser ComboBox wird sogar gespeichert, wenn Sie zwischen den erweiterbaren Merkmalseiten navigieren.

Einige Zellen in der DataGrid-Anzeige [Zum Erweitern klicken]. Diese Meldung bedeutet, dass die Metadaten, die sich auf diese Eigenschaft beziehen, zu ausführlich sind, um in einer Zelle des DataGrid ordnungsgemäß angezeigt zu werden. Durch Klicken auf die Zelle wird ein modales Dialogfeld geöffnet, in dem der tatsächliche Wert dieser Zelle angezeigt wird.

Erweiterbare Infrastrukturseiten

Seite "Ereignisse"

Auf der Ereignisseite wird angezeigt, wenn "etwas passiert" in der IDE. Jedes Ereignis wird zusammen mit allen Eigenschaften im Zusammenhang mit diesem Ereignis als neue Zeile im DataGrid angezeigt. Wenn beispielsweise ein Befehl ausgeführt wird, erscheint ein Befehle - Ausführung Ereignis in der Anzeige, das die ID der Erweiterung zeigt, zu der der Befehl gehört, sowie die ID des ausgeführten Befehls.

Sie können das Event ComboBox verwenden, um die Ansicht so zu filtern, dass nur Ereignisse mit einem bestimmten Namen enthalten sind. Wenn Alle ausgewählt ist, werden alle Ereignisse angezeigt. Wenn ein bestimmtes Ereignis ausgewählt ist, werden alle Eigenschaften des Ereignisses in der Ansicht angezeigt. Einige Eigenschaften müssen erweitert werden, indem sie auf [Zum Erweitern klicken] klicken, wenn sie zu ausführlich sind, um in einer einzelnen Zelle angezeigt zu werden.

Die ComboBox für den Vertrag filtert die Ansicht, sodass nur Ereignisse angezeigt werden, die sich auf eine spezifische erweiterbare Funktion beziehen. Außerdem wird die ComboBox Event so gefiltert, dass nur die Namen von Ereignissen im Zusammenhang mit dem erweiterbaren Feature enthalten sind.

Durch Klicken auf die Schaltfläche Alle löschen werden alle Ereignisse gelöscht, die aktuell in der Ansicht angezeigt werden.

Spaltenbeschreibungen

Erweiterungs-ID

In der Spalte Erweiterungs-ID wird die ID der Erweiterung angezeigt, mit der die Instanz des Ereignisses verknüpft ist. Es ist möglich, dass diese Zelle für einige Ereignisse leer ist, wenn sie nicht zu einer bestimmten Erweiterung gehören, sondern stattdessen auf die IDE als Ganzes angewendet werden.

Artikel-ID

In der Spalte Element-ID wird die ID des Erweiterungselements angezeigt, mit dem die Instanz des Ereignisses verknüpft ist. Die Element-ID für das Ereignis Befehle – Ausführen wäre beispielsweise die ID des ausgeführten Befehls.

Eigenschaften

In der Spalte Eigenschaften werden die Eigenschaften dieser Ereignisinstanz angezeigt, die in einer einzelnen Zelle eines DataGrids dargestellt werden können. Ausführlichere Eigenschaften wären nur im Dialogfeld Weitere Informationen sichtbar, oder indem Sie die ComboBox für das Ereignis in den Namen des spezifischen Ereignisses ändern, an dem Sie interessiert sind.

Weitere Informationen

In der Spalte Weitere Informationen werden ausführlichere Metadaten im Zusammenhang mit einem Ereignis angezeigt. Durch Klicken auf eine Zelle in dieser Spalte wird ein modales Dialogfeld geöffnet, das alle Metadaten enthält, die mit dem durch diese Zeile dargestellten Ereignis zusammenhängen.

Clientkontextseite

Die Clientkontextseite zeigt den Status verschiedener Eigenschaften im Zusammenhang mit der IDE selbst an. Das Context ComboBox ändert die Daten in der Ansicht so, dass entweder alle Aktivierungseinschränkungen, die mit dem aktuell im Client Contexts ComboBox ausgewählten Element zusammenhängen, oder ein Protokoll aller Änderungen dieser Eigenschaften seit dem Öffnen des Toolfensters angezeigt werden. Wenn der Ereignisse-Kontext ausgewählt ist, kann die -Schaltfläche „Alle löschen“ verwendet werden, um alle Ereignisse zu löschen, die derzeit in der Ansicht angezeigt werden.