Anzeigen von Threads und Tasks im Fenster „Parallele Stapel“ (C#, Visual Basic, C++)

Das Fenster Parallele Stapel ist beim Debuggen von Multithreadanwendungen hilfreich. Das Fenster enthält mehrere Ansichten:

• In der Threadansicht werden Informationen zur Aufrufliste für alle Threads in der App angezeigt. Sie können zwischen Threads und Stapelrahmen in diesen Threads navigieren.

• In der Aufgabenansicht werden aufgabenorientierte Aufruflisteninformationen angezeigt.

  • In verwaltetem Code werden in der Aufgabenansicht Aufruflisten von System.Threading.Tasks.Task-Objekten angezeigt.
  • In nativem Code werden in der Aufgabenansicht Aufruflisten von Aufgabengruppen, parallelen Algorithmen, asynchronen Agents und einfachen Aufgaben angezeigt.

• In der Methodenansicht wird die Aufrufliste einer ausgewählten Methode pivotiert.

Verwenden des Fensters „Parallele Stapel“

Sie müssen sich in einer Debugsitzung befinden, um das Fenster Parallele Stapel zu öffnen. Klicken Sie auf Debuggen>Fenster>Parallele Stapel.

Symbolleisten-Steuerelemente

Das Fenster Parallele Stapel enthält die folgenden Symbolleisten-Steuerelemente:

Symbol	Steuerelement	Beschreibung
	Kombinationsfeld Threads/Aufgaben	Schaltet die Ansicht zwischen Aufruflisten von Threads und Aufruflisten von Aufgaben um. Weitere Informationen finden Sie unter Aufgabenansicht und Threadansicht.
	Filtersteuerelement	Zeigt Aufruflisten nur für die spezifische Gruppe von Threads an, die Sie interessieren.
	Nur gekennzeichnete Elemente anzeigen	Mit dieser Option werden nur Aufruflisten für die Threads angezeigt, die in anderen Debuggerfenstern wie den Fenstern GPU-Threads und Parallele Überwachung gekennzeichnet wurden.
	Methodenansicht umschalten	Mit dieser Option können Sie zwischen der Aufruflistenansicht und der Methodenansicht wechseln. Weitere Informationen finden Sie unter Methodenansicht.
	Automatischen Bildlauf zu aktuellem Stapelrahmen durchführen	Mit dieser Option können Sie im Graph automatisch zum aktuellen Stapelrahmen scrollen. Dieses Feature ist nützlich, wenn Sie den aktuellen Stapelrahmen über andere Fenster ändern oder wenn Sie einen neuen Haltepunkt in großen Graphen erreichen.
	Zoomsteuerung ein- bzw. ausschalten	Mit dieser Option wird das Zoomsteuerelement auf der linken Seite des Fensters ein- und ausgeblendet. Unabhängig davon, ob das Zoomsteuerelement angezeigt wird, können Sie auch herein- und herauszoomen, indem Sie STRG drücken und das Mausrad drehen oder indem Sie STRG+UMSCHALT++ zum Hereinzoomen und STRG+UMSCHALT+- zum Herauszoomen drücken.
	Suchsteuerelement	Mit dieser Funktion können Sie einfach Stapelrahmen durchsuchen und dann Pfeile verwenden, um zwischen diesen Ergebnissen zu navigieren.
	Steuerelement „Speichern“	Ermöglicht das Speichern/Exportieren des Inhalts aus dem Fenster mit parallelen Stapeln als Bild.
	Steuerelement „Externen Code anzeigen“	Mit diesem Feature können Sie die Stapel im externen Code/in den externen Bibliotheken ein- und ausblenden.

Stapelrahmensymbole

Die folgenden Symbole geben Informationen zu den aktiven und aktuellen Stapelrahmen in allen Ansichten an:

Symbol	Beschreibung
	Dieses Symbol gibt die aktuelle Position (aktiver Stapelrahmen) des aktuellen Threads an.
	Dieses Symbol gibt die aktuelle Position (aktiver Stapelrahmen) von nicht aktuellen Threads an.
	Dieses Symbol gibt den aktuellen Stapelrahmen an (aktueller Debuggerkontext). Der Methodenname wird immer fett formatiert.
	Gibt an, dass der aktuelle Stapelrahmen eine Warnung zu einem kritischen Status wie aufweist, etwa einem Deadlock.
	Gibt den Knoten mit Deadlock an.
	Gibt an, dass der aktuelle Stapelrahmen zusätzliche Informationen enthält, z. B. „Warten auf“, „Warten auf Sperre“, „Im Besitz von“ usw.
	Gibt an, dass sich die aktuelle Aufgabe im Status „Blockiert“/„Warten“ usw. befindet.
	Gibt an, dass derzeit ein Task ausgeführt wird.

Kontextmenüelemente

Die folgenden Kontextmenüelemente sind verfügbar, wenn Sie mit der rechten Maustaste auf eine Methode in den Ansichten Threads oder Aufgaben klicken. Die letzten sechs Elemente sind mit denen im Aufruflistenfenster identisch.

Menüoption	BESCHREIBUNG
Copy	Kopiert das ausgewählte Element.
Alle Rahmen auswählen unter	Wählt alle Rahmen unter dem ausgewählten Stapel aus.
Kennzeichnen	Kennzeichnet das ausgewählte Element.
Kennzeichnung aufheben	Hebt die Kennzeichnung des ausgewählten Elements auf.
Einfrieren	Friert das ausgewählte Element ein.
Reaktivieren	Reaktiviert das ausgewählte Element.
Zu Rahmen wechseln	Dieses Element ist identisch mit dem entsprechenden Menübefehl im Fenster Aufrufliste. Im Fenster Parallele Stapel kann sich eine Methode jedoch in mehreren Rahmen befinden. Sie können den Rahmen auswählen, der im untergeordneten Menü des Elements enthalten sein soll. Wenn sich einer der Stapelrahmen im aktuellen Thread befindet, wird dieser Rahmen standardmäßig im untergeordneten Menü ausgewählt.
Zur Aufgabe wechseln oder Gehe zu Thread	Mit diesem Menüelement wechseln Sie zwischen den Ansichten Aufgabe und Threads. Dabei wird derselbe Stapelrahmen hervorgehoben.
Gehe zu Quellcode	Mit diesem Menüelement navigieren Sie zur entsprechenden Position im Quellcodefenster.
Zu Disassemblierung wechseln	Mit diesem Menüelement navigieren Sie zur entsprechenden Position im Fenster Disassemblierung.
Externen Code anzeigen	Blendet externen Code ein bzw. aus.
Hexadezimale Anzeige	Schaltet zwischen dezimaler und hexadezimaler Anzeige um.
Threads in Quelle anzeigen	Mit diesem Menüelement wird die Position des Threads im Quellcodefenster hervorgehoben.
Symbolladeinformationen	Mit diesem Menüelement wird das Dialogfeld Symbolladeinformationen geöffnet.
Symboleinstellungen	Mit diesem Menüelement wird das Dialogfeld Symboleinstellungen geöffnet.

Threadansicht

In der Ansicht Threads werden der Stapelrahmen und der Aufrufpfad des aktuellen Threads blau hervorgehoben. Die aktuelle Position des Threads wird vom gelben Pfeil angezeigt.

Doppelklicken Sie auf eine andere Methode, um den aktuellen Stapelrahmen zu ändern. Dies kann auch zu einem Wechsel des aktuellen Threads führen, je nachdem, ob die ausgewählte Methode Teil des aktuellen oder eines anderen Threads ist.

Wenn der Graph der Ansicht Threads zu groß ist, um in das Fenster zu passen, wird im Fenster das Steuerelement Vogelperspektive angezeigt. Sie können den Rahmen im Steuerelement bewegen, um zu verschiedenen Abschnitten des Graphen zu navigieren.

In der folgenden Abbildung wird ein Thread gezeigt, der von der Main-Methode zu einem Übergang von verwaltetem zu nativem Code wechselt. In der aktuellen Methode befinden sich fünf Threads. Einer wechselt zu „ServerClass.InstanceMethod“, ein anderer zu „Worker.Thread.Start“ und dann zu „StartupHook.Initialize.AnonymousMethod“.

In der folgenden Tabelle werden die Hauptfeatures der Ansicht Threads beschrieben:

Legende	Elementname	BESCHREIBUNG
1	Aufruflistensegment oder -knoten	Dieses Element enthält eine Reihe von Methoden für einen oder mehrere Threads. Wenn keine Pfeillinien mit dem Rahmen verbunden sind, zeigt der Rahmen den gesamten Aufrufpfad für die Threads an.
2	Blaue Hervorhebung	Gibt den Aufrufpfad des aktuellen Threads an.
3	Pfeillinien	Diese verbinden Knoten, um den gesamten Aufrufpfad für den Thread bzw. die Threads darzustellen.
4	Knotenheader	Zeigt die Anzahl der Prozesse/Threads, den Threadnamen und die Thread-ID für den Knoten an.
5	Methode	Stellt einen oder mehrere Stapelrahmen in derselben Methode dar.
6	QuickInfo zur Methode	Dieses Element wird angezeigt, wenn Sie auf eine Methode zeigen. In der Threadansicht zeigt die QuickInfo alle Threads in einer Tabelle ähnlich wie im Fenster Threads an.

Aufgabenansicht

Wenn Ihre App System.Threading.Tasks.Task-Objekte (verwalteter Code) oder task_handle-Objekte (nativer Code) verwendet, um Parallelität auszudrücken, können Sie die Ansicht Aufgaben verwenden. In der Aufgabenansicht werden Aufruflisten von Aufgaben anstelle von Threads angezeigt.

In der Ansicht Aufgaben:

• werden Aufruflisten von Threads nicht angezeigt, die keine Aufgaben ausführen.
• werden Aufruflisten von Threads, die Aufgaben ausführen, oben und unten abgeschnitten, um die relevantesten Rahmen für Aufgaben anzuzeigen.
• werden die Aufruflisten dieser Aufgaben in separaten Knoten angezeigt, wenn sich mehrere Aufgaben in einem Thread befinden.

Wechseln Sie zurück zur Ansicht Threads, indem Sie mit der rechten Maustaste in einen Stapelrahmen klicken und Gehe zu Thread auswählen, um die gesamte Aufrufliste anzuzeigen.

In der folgenden Abbildung wird die Ansicht Threads oben und die dazugehörige Ansicht Aufgaben unten veranschaulicht.

Zeigen Sie auf eine Methode, um eine QuickInfo mit zusätzlichen Informationen anzuzeigen. In der Ansicht Aufgaben zeigt die QuickInfo ähnlich wie im Fenster Aufgaben alle Aufgaben in einer Tabelle.

In der folgenden Abbildung werden die QuickInfo für eine Methode in der Ansicht Threads oben und die dazugehörige Ansicht Aufgaben unten angezeigt.

Methodenansicht

Über die Ansichten Threads und Aufgaben können Sie den Graphen zur aktuellen Methode pivotieren, indem Sie in der Symbolleiste auf das Symbol Methodenansicht umschalten klicken. In der Methodenansicht werden alle Methoden für sämtliche Threads in einem Blick angezeigt, die entweder Aufrufer oder Aufgerufene der aktuellen Methode sind. In der folgenden Abbildung wird veranschaulicht, wie die gleichen Informationen in der Ansicht Threads links und der Methodenansicht rechts dargestellt werden.

Wenn Sie zu einem neuen Stapelrahmen wechseln, legen Sie diese Methode als aktuelle Methode fest und die Methodenansicht zeigt alle Aufrufer und Aufgerufenen für die neue Methode an. Dabei werden möglicherweise einige Threads in der Ansicht eingeblendet oder ausgeblendet, je nachdem, ob die betreffende Methode in ihren Aufruflisten enthalten ist. Klicken Sie wieder auf das Symbol Methodenansicht in der Symbolleiste, um zur Aufruflistenansicht zurückzukehren.

Videotutorial zum Debuggen von Threads und Aufgaben mit parallelen Stapeln

Diese Videotutorials veranschaulichen, wie Sie die Ansichten „Threads“ und „Aufgaben“ des Fensters „Parallele Stapel“ in Visual Studio 2022 verwenden können, um Ihre Multithreadanwendungen zu debuggen.

• Debugging tasks with the Parallel Stacks window (Debuggen von Aufgaben mit dem Fenster „Parallele Stapel“)
• Debugging threads with the Parallel Stacks window (Debuggen von Threads mit dem Fenster „Parallele Stapel“)

Zugehöriger Inhalt

• Erste Schritte zum Debuggen von Multithreadanwendungen (C#, Visual Basic, C++)
• Exemplarische Vorgehensweise: Debuggen einer parallelen Anwendung
• Vorgehensweise: Wechseln zu einem anderen Thread während des Debuggens in Visual Studio (C#, Visual Basic, C++)
• Debuggen von verwaltetem Code
• Parallele Programmierung
• Use the Tasks window (Verwenden des Fensters „Aufgaben“)
• Task class (Task-Klasse)