Overzicht

De extensie VisualStudio.Extensibility Diagnostics Explorer is ontworpen om fouten op te sporen in VisualStudio.Extensibility-extensies tijdens het ontwikkelen. De doelgroep voor deze extensie is auteurs van extensies, niet extensiegebruikers. Deze extensie biedt een interface voor het inspecteren van de uitbreidbaarheidspunten waarmee extensies communiceren en met welke configuratieobjectextensies de IDE wordt geleverd, en de metagegevens van deze configuratieobjecten.

Aan de slag

Volg deze instructies om diagsnotics Explorer te installeren, te starten en te configureren.

De extensie installeren

U kunt Diagnostics Explorer rechtstreeks downloaden via Extension Manager in Visual Studio of vanuit de Visual Studio Marketplace hier.

Notitie

De extensie VisualStudio.Extensibility Diagnostics Explorer is compatibel met Visual Studio 2022 17.12 en hoger.

De Diagnostics Explorer openen in Visual Studio

Als u Diagnostics Explorer in Visual Studio wilt starten, selecteert u VisualStudio.Extensibility Diagnostics Explorer in het menu Extensions.

Verzameling diagnostische gegevens inschakelen

Diagnostics Explorer is geconfigureerd om standaard relevante diagnostische gegevens van uw extensies te verzamelen. Als u deze gegevensverzameling wilt uitschakelen of opnieuw wilt inschakelen, kunt u het selectievakje Verzamelen van diagnostische gegevens inschakelen selectievakje in de linkerbenedenhoek van het taakvenster in- of uitschakelen. Er is een herstart van Visual Studio vereist om wijzigingen in deze instelling van kracht te laten worden.

Diagnostiekpagina's

Het linkerdeelvenster van het hulpprogramma Diagnostics Explorer bevat een lijst met verschillende diagnostische pagina's. Er zijn twee soorten diagnostische pagina's: uitbreidbare functies en uitbreidbaarheidsinfrastructuur. Pagina's met uitbreidbare functies bieden diagnostische informatie over een specifiek uitbreidbaar onderdeel in Visual Studio, zoals opdrachten. Uitbreidbaarheidsinfrastructuurpagina's bieden diagnostische informatie die relevant is, ongeacht de uitbreidbaarheidspunten waarop uw extensies zijn aangesloten. De gebeurtenissen pagina, een live viewer voor uitbreidbaarheidsgerelateerde gebeurtenissen en de clientcontexten pagina, waarin de relevante IDE-status wordt weergegeven om u te helpen bij het maken van uw activeringsbeperkingen, zijn de twee uitbreidbaarheidsinfrastructuurpagina's.

Uitbreidbare functiepagina's

Uitbreidbare functiepagina's hebben linksboven een keuzelijst met invoervak voor de verschillende Uitbreidbaarheidspunten in dat functiegebied, die elk rechtstreeks aan configuratieobjecten in uw extensie kunnen worden toegewezen. Op de pagina Opdrachten is er bijvoorbeeld een Uitbreidbaarheidspunt voor menu's en werkbalken, waarin u alle menu's en werkbalken ziet die Visual Studio heeft gedetecteerd in uw VisualStudio.Extensibility-extensies.

De gegevens worden in realtime bijgewerkt wanneer eigenschappen worden bijgewerkt in extensies. Als een extensie bijvoorbeeld de weergavenaam van een van de opdrachten tijdens runtime wijzigt, wordt de nieuwe weergavenaam van die opdracht weergegeven in de cel in de kolom Weergavenaam kolom voor die opdracht onmiddellijk.

Het Uitbreidbaarheidspunt Combobox bevat ook een item met de naam Logboek, die u een live-weergave van deze updates toont. De knop Alles wissen naast de ComboBox kan worden gebruikt om alle regels die momenteel op het scherm worden weergegeven, te wissen.

U kunt de items in de weergave filteren met behulp van de Extensions ComboBox. Wanneer Alle is geselecteerd in deze keuzelijst met invoervak, worden de gegevens voor elke geïnstalleerde VisualStudio.Extensibility-extensie weergegeven. Als u deze keuzelijst wijzigt in de ID van een specifieke extensie, worden alleen de items weergegeven die gerelateerd zijn aan die specifieke extensie. De waarde van deze keuzelijst met invoervak blijft behouden, zelfs wanneer u tussen uitbreidbare functiepagina's navigeert.

Sommige cellen in de DataGrid-weergave [Klik om uit te vouwen]. Dit bericht betekent dat de metagegevens met betrekking tot die eigenschap te uitgebreid zijn om netjes weer te geven in een cel van DataGrid. Als u op de cel klikt, wordt een modaal dialoogvenster geopend met de werkelijke waarde van die cel.

Pagina's voor uitbreidbare infrastructuur

Pagina Gebeurtenissen

Op de gebeurtenissenpagina ziet u wanneer er 'iets gebeurt' in de IDE. Elke gebeurtenis wordt weergegeven als een nieuwe rij in DataGrid, samen met alle eigenschappen die betrekking hebben op die gebeurtenis. Wanneer een opdracht wordt uitgevoerd, verschijnt bijvoorbeeld een opdrachten - uitvoeren gebeurtenis in de weergave die de id van de extensie toont waartoe de opdracht behoort en de id van de opdracht die is uitgevoerd.

U kunt de Evenement Combobox gebruiken om de weergave te filteren op alleen evenementen met een specifieke naam. Wanneer Alle is geselecteerd, worden alle gebeurtenissen weergegeven. Als een specifieke gebeurtenis is geselecteerd, worden alle eigenschappen van de gebeurtenis weergegeven in de weergave. Sommige eigenschappen moeten worden uitgevouwen door te klikken op [Klik om uit te vouwen] als ze te uitgebreid zijn om in één cel te worden weergegeven.

De Contract keuzelijst filtert de weergave zodat alleen gebeurtenissen worden getoond die betrekking hebben op een specifieke uitbreidbare functie. Het filtert ook de Event keuzelijst om alleen namen van gebeurtenissen die met de specifieke uitbreidbare functie te maken hebben op te nemen.

Als u op de knop Alle wissen klikt, worden alle gebeurtenissen verwijderd die momenteel in de weergave worden weergegeven.

Kolombeschrijvingen

Extensie-id

De kolom Extensie-ID toont de ID van de extensie waarmee de instantie van de gebeurtenis is gerelateerd. Het is mogelijk dat deze cel leeg is voor sommige gebeurtenissen als ze geen deel uitmaken van een specifieke extensie, maar in plaats daarvan van toepassing zijn op de IDE als geheel.

Item-id

In de kolom Item-ID wordt de ID weergegeven van het extensie-item waaraan de instantie van het event is gerelateerd. De Item Id voor het Commands - Executing evenement zou bijvoorbeeld de ID zijn van het commando dat werd uitgevoerd.

Eigenschappen

In de kolom Eigenschappen ziet u de set eigenschappen die betrekking hebben op dat exemplaar van de gebeurtenis die in één cel in een DataGrid kan worden weergegeven. Uitgebreidere eigenschappen zijn alleen zichtbaar in het dialoogvenster Meer informatie of door de Evenement keuzelijst te wijzigen in de naam van het specifieke evenement waarin u geïnteresseerd bent.

Meer informatie

In de kolom Meer informatie worden uitgebreide metagegevens weergegeven die betrekking hebben op een gebeurtenis. Als u op een cel in deze kolom klikt, wordt een modaal dialoogvenster geopend met alle metagegevens die betrekking hebben op de gebeurtenis die wordt vertegenwoordigd door die rij.

Pagina Clientcontexten

Op de pagina clientcontexten ziet u de status van verschillende eigenschappen die betrekking hebben op de IDE zelf. De Context Keuzelijst met invoervak wijzigt de gegevens in de weergave om alle activeringsbeperkingen weer te geven die betrekking hebben op het momenteel geselecteerde item in de Clientcontexten Keuzelijst met invoervak, of een logboek met alle keren dat deze eigenschappen zijn gewijzigd sinds het venster van het hulpprogramma is geopend. Wanneer de gebeurtenissen context is geselecteerd, kan de knop Alles wissen worden gebruikt om alle gebeurtenissen te verwijderen die momenteel getoond worden.