Freigeben über


Anzeigen und Ändern von Variablenwerten mit DataTips im Code-Editor

Dieser Artikel zeigt, wie Sie mit der DataTips-Funktion in Visual Studio arbeiten können. Datentipps bieten eine bequeme Möglichkeit, Informationen über Variablen in Ihrem Programm anzuzeigen, während Sie Ihren Code debuggen. Wenn Sie Haltepunkte in Ihrem Code festlegen und mit dem Debuggen beginnen, werden Datentipps für Variablen sichtbar, sobald sie in den aktuellen Bereich der Ausführung gelangen. Sie können den Datentipp verwenden, um den Wert für eine Variable im Bereich zu ändern, und den Code über dem Haltepunkt erneut ausführen, um die Auswirkungen der Änderung zu sehen.

Screenshot einer Debugging-Sitzung in Visual Studio mit Beispielen für Datentipps für Variablen im Bereich.

Tipp

Wenn Sie mit dem Debuggen noch nicht vertraut sind, sollten Sie Debugging für absolute Anfänger und Debugging-Techniken und Tools lesen, bevor Sie diesen Artikel durcharbeiten.

Voraussetzungen

  • Visual Studio. Wenn Sie Visual Studio noch nicht installiert haben, können Sie es unter Visual Studio-Downloads kostenlos herunterladen.

  • Etwas Programmcode zum Ausführen im Visual Studio-Debugger.

Arbeiten mit DataTips

Datentipps sind während einer Debugging-Sitzung sichtbar, wenn Sie Haltepunkte in Ihrem Code festgelegt haben. Wenn der Debugger die Programmausführung an einem Haltepunkt unterbricht, sind Datentipps für alle Variablen im aktuellen Bereich verfügbar.

Der Prozess hierfür ist folgender:

  1. Legen Sie einen Haltepunkt in Ihrem Code fest und starten Sie das Debugging, indem Sie Debuggen>Debugging starten wählen oder die Tastenkombination F5 verwenden.

  2. Wenn der Debugger die Ausführung am Haltepunkt unterbricht, bewegen Sie den Mauszeiger über eine beliebige Variable im aktuellen Bereich, um den Datentipp zu öffnen.

  3. Verwenden Sie den Datentipp, um den Namen der Variablen zu sehen und mit dem Wert zu arbeiten.

  4. Ändern Sie bei Bedarf den Wert für eine Variable oder fügen Sie Kommentare hinzu.

Hinweis

Visual Studio wertet den Wert für die Variable in einem Datentipp auf der Grundlage des Kontexts aus, in dem der Debugger bei der Ausführung angehalten wird, und zeigt ihn am Bildschirm an. Die Auswertung basiert nicht auf der aktuellen Position des Cursors oder des Datentipps. Wenn Sie mit dem Mauszeiger über eine Variable in einer anderen Funktion fahren, die denselben Namen hat wie eine Variable im aktuellen Kontext, zeigt Visual Studio den Wert der Variable im Datentipp für den aktuellen Kontext an.

Visual Studio unterstützt viele Aktionen für Datentipps und die Arbeit mit den Variablen und Werten, darunter:

  • Einen Datentipp anheften oder schweben lassen, damit er bei der Ausführung von Code sichtbar bleibt
  • Aktivierung von fixierten Datentipps, die erweitert bleiben, bis Sie eine andere Auswahl treffen
  • Erweiterung des Datentipps für ein Array, eine Struktur oder ein Objekt, um dessen Mitglieder in einem Baumformat zu sehen
  • Ändern des Wertes für eine Variable in einem Datentipp
  • Hinzufügen von mehrzeiligen Kommentaren zu einem angehefteten Datentipp, um während des Debuggens Notizen zu machen
  • Importieren und Exportieren von DataTips

Datentipps transparent machen

Wenn Sie den Mauszeiger über eine Variable bewegen, um den Datentipp anzuzeigen, können Sie den Datentipp transparent machen, um den darunter liegenden Code zu sehen. Diese Aktion schaltet auch die Transparenz für andere Tippaktionen im Code-Editor ein, z. B. für Methodendefinitionen und die Syntax von Ausdrücken.

Um die Transparenz zu aktivieren, gehen Sie folgendermaßen vor:

  1. Wählen Sie im Visual Studio Code-Editor einen Datentipp aus, und halten Sie dann die STRG-Taste gedrückt.

  2. Um die Transparenz beizubehalten, halten Sie weiterhin die STRG-Taste gedrückt.

  3. Um die Transparenz zu beenden, lassen Sie die STRG-Taste los oder wählen Sie eine andere Stelle aus.

Für angeheftete oder schwebende Datentipps ist die Transparenz nicht verfügbar.

Datentipps in erweiterter Form beibehalten

Wenn Sie in Visual Studio 2022 Update 1 und höher einen Datentipp erweitern, können Sie ihn so lange erweitert lassen, bis Sie eine andere Auswahl treffen. Diese Aktion führt zu einem fixierten Datentipp.

Gehen Sie folgendermaßen vor, um einen Datentipp zu fixieren:

  1. Wählen Sie in Visual Studio Debuggen>Optionen, um den Dialog Optionen zu öffnen.

  2. Suchen Sie auf der Registerkarte Allgemein nach der Option Erweiterte Datentipps offen halten, bis sie weggeklickt werden.

  3. Aktivieren Sie das Kontrollkästchen, um die Option zu aktivieren, und wählen Sie OK.

Wenn die Fixierungsoption aktiviert ist, bleibt jeder Datentipp, den Sie im Code-Editor erweitern, offen.

Anheften von Datentipps

Sie können einen Datentipp anheften, um ihn auf der Oberfläche des Code-Editors offen zu halten. Sie können auch die Position des angehefteten Datentipps ändern.

Um einen Datentipp anzuheften, gehen Sie folgendermaßen vor:

  1. Bewegen Sie im Visual Studio Code-Editor den Mauszeiger über eine Variable, um den Datentipp anzuzeigen.

  2. Wählen Sie im Datentipp den Pin, um An Quelle anheften zu wählen:

    Screenshot, der zeigt, wie Sie einen Datentipp anheften und an eine beliebige Stelle auf der Oberfläche des Code-Editors verschieben können.

    Visual Studio heftet den Datentipp an eine Stelle in der Nähe der Variablen auf der Oberfläche an. Ein Pin erscheint in der Leiste des Code-Editors neben der Zeile, in der Sie den Datentipp anheften.

  3. Wählen Sie den angehefteten Datentipp aus, und ziehen Sie ihn an eine beliebige Stelle auf der Oberfläche des Code-Editors.

Datentipps schweben lassen (Anheftung aufheben)

Nachdem Sie einen Datentipp angeheftet haben, können Sie den Datentipp wieder lösen und ihn schwebend machen. Ein schwebender Datentipp kann überall in der Visual Studio-IDE positioniert werden.

Gehen Sie folgendermaßen vor, um einen Datentipp zu verschieben:

  1. Wählen Sie in einem angehefteten Datentipp mit dem Pin die Option Von Quelle lösen.

    Visual Studio hebt die Anheftung des Datentipps auf und gibt dem Datentipp einen einfarbigen Hintergrund. Der Pin für den Datentipp wechselt in die Position, in der er nicht mehr angeheftet ist, und der Pin in der Leiste des Code-Editors wird entfernt.

    Screenshot, der zeigt, wie Sie einen Datentipp an einer beliebigen Stelle in der Visual Studio-IDE verschieben können.

  2. Wählen Sie den schwebenden Datentipp aus und ziehen Sie ihn an eine beliebige Stelle in der Visual Studio-IDE.

    Wenn Sie den schwebenden Datentipp außerhalb der Oberfläche des Code-Editors positionieren, wird der Pin aus dem Seitenmenü des Datentipps entfernt. Die Option An die Quelle anheften ist nur verfügbar, wenn der Datentipp auf der Oberfläche des Code-Editors positioniert ist.

Datentipps neu anheften

Nachdem Sie einen Datentipp schwebend platziert haben, können Sie ihn an einer bestimmten Quellposition auf der Oberfläche des Code-Editors wieder anheften.

Gehen Sie wie folgt vor, um einen schwebenden Datentipp wieder anzuheften:

  1. Wählen Sie den schwebenden Datentipp aus, verschieben Sie ihn und positionieren Sie ihn auf der Oberfläche des Code-Editors.

  2. Wählen Sie in dem schwebenden Datentipp mit dem Pin An Quelle anheften.

    Der Pin wechselt in die angeheftete Position. Der Datentipp wird an einer bestimmten Stelle im Code-Editor neu angeheftet, und in der Leiste des Code-Editors erscheint ein Pin für die Quelle.

Datentipps schließen

Es gibt mehrere Möglichkeiten, Datentipps in Visual Studio zu schließen.

Wenn Sie Ihre Debugging-Sitzung beenden und noch Datentipps geöffnet haben, schließt Visual Studio diese für Sie. Wenn Sie eine weitere Debugging-Sitzung starten, versucht Visual Studio, alle Datentipps, die Sie zuvor offen gelassen haben, wiederherzustellen.

In der folgenden Tabelle ist zusammengefasst, wie Sie Datentipps manuell schließen können:

Ziel schließen Aktion
Spezifischer Datentipp Wählen Sie das X im Datentipp.
Alle Datentipps für eine bestimmte Datei Wählen Sie Debuggen>Alle Datentipps, die an <Dateiname> angeheftet sind löschen in der Visual Studio Symbolleiste.
Alle geöffneten Datentipps Wählen Sie Debuggen>Alle Datentipps löschen in der Visual Studio Symbolleiste.

Arbeiten mit Variablen und Werten in Datentipps

Wenn Sie mit Datentipps in Visual Studio arbeiten, haben Sie die Möglichkeit, Details zu Variablen und Objekten anzuzeigen und Werte während des Debuggens zu bearbeiten. Diese Funktionalitäten sind nützlich für die schnelle Fehlerbehebung und das Testen von Änderungen an Ihrem Code.

Erweitern von Objekten in Datentipps zur Anzeige von Mitgliedern

Wenn ein Datentipp ein Array, eine Struktur oder ein Objekt darstellt, können Sie die Ansicht des Datentipps erweitern, um die Mitglieder zu sehen. In der erweiterten Ansicht werden die zusätzlichen Informationen in einem hierarchischen Baumformat angezeigt.

Um die Ansicht für ein Objekt in einem Datentipp zu erweitern, gehen Sie folgendermaßen vor:

  1. Wählen Sie in einem Datentipp für ein Array, eine Struktur oder ein Objekt den Erweiterungspfeil vor dem Elementnamen, um die Mitglieder anzuzeigen. Die Ansicht wird in einem Baumformat dargestellt:

    Screenshot, der zeigt, wie Sie den Erweiterungspfeil für ein Objekt in einem Datentipp auswählen.

    Für einen angehefteten Datentipp wählen Sie das Plus-Symbol (+) vor dem Variablennamen, um die Definition zu erweitern.

  2. Wählen Sie weiterhin die Pfeile zum Erweitern, um mehr von der Mitgliederhierarchie zu sehen:

    Screenshot, der zeigt, wie Sie den Objektbaum weiter erweitern können, um die Mitgliederhierarchie anzuzeigen.

  3. Um sich in der erweiterten Ansicht nach oben und unten zu bewegen, verwenden Sie die Maus oder die Aufwärts- und Abwärtspfeiltasten der Tastatur.

  4. Um ein erweitertes Mitglied mit dem ursprünglich angehefteten Datentipp anzuheften, verwenden Sie den Pin auf dem Mitglied und wählen An Quelle anheften. Nachdem Sie die Baumansicht geschlossen haben, bleiben alle angehefteten Elemente mit dem angehefteten Datentipp sichtbar.

Variablenwerte bearbeiten

Ein weiterer Vorteil der Arbeit mit Datentipps ist die Möglichkeit, den Wert einer Variablen oder eines Elements in einem Datentipp während des Debuggens zu bearbeiten. Diese Funktion ist nützlich, um kleine Änderungen an Ihrem Code schnell zu testen.

Um den Wert einer Variablen oder eines Elements in einem Datentipp zu bearbeiten, gehen Sie wie folgt vor:

  1. Wählen Sie im Datentipp den Wert aus. Visual Studio hebt den Wert hervor und macht ihn zur Bearbeitung verfügbar.

  2. Geben Sie einen neuen Wert in den Datentipp ein und wählen Sie Eingabe.

Beachten Sie, dass einige Variablenwerte nur schreibgeschützt sind. Visual Studio stellt schreibgeschützte Werte nicht zur Bearbeitung zur Verfügung.

Kommentare in Datentipps verwenden

Die Region Kommentare eines Datentipps ist nützlich, um Notizen zu Variablen zu machen, während Sie Ihren Code debuggen. Diese Region ist ein praktischer Ort, um verschiedene Werte zu verfolgen, wenn sie sich während des Debuggens ändern. Sie können Kommentare in einen angehefteten oder unverankerten Datentipp einfügen.

Um Kommentare in einem Datentipp zu verwenden, gehen Sie folgendermaßen vor:

  1. Wählen Sie im Datentipp mit dem Doppelpfeil nach unten Erweitern, um Kommentar zu sehen. Der Doppelpfeil nach unten öffnet die Region Kommentare des Datentipps, in der Sie Anmerkungen hinzufügen können.

  2. Um einen Kommentar hinzuzufügen, setzen Sie den Cursor in die Region Kommentare und geben Sie Text ein. Die Region ist für mehrere Zeilen geeignet.

    Screenshot, der zeigt, wie Sie Kommentare in einen Datentipp eingeben.

  3. Um die Region Kommentare zu schließen, verwenden Sie den Doppelpfeil nach oben für Kommentare schließen. Alle von Ihnen eingegebenen Kommentare verbleiben im Datentipp, sind aber derzeit nicht sichtbar.

Anheften von Eigenschaften in Datentipps

Visual Studio unterstützt das Anheften von Eigenschaften in angehefteten Datentipps in .NET Core 3.0 und höher. Mit dieser Funktion können Sie Objekte in Datentipps schnell anhand ihrer Eigenschaften überprüfen.

Um Eigenschaften in Datentipps anzuheften, gehen Sie folgendermaßen vor:

  1. Erweitern Sie in einem angehefteten Datentipp die Hierarchie der Mitglieder, bis Sie eine Eigenschaft sehen, die Sie mit dem Datentipp sichtbar halten möchten.

  2. Verwenden Sie den Pin für die Eigenschaft, um sie an den Datentipp anzuheften. Sie können auch mit der rechten Maustaste auf die Eigenschaft klicken und Mitglied als Favorit anheften wählen.

    Visual Studio verschiebt die ausgewählte Eigenschaft an den Anfang der Eigenschaftsliste des Objekts. Der Name und der Wert der Eigenschaft werden in der rechten Spalte des angehefteten Datentipps angezeigt:

    Screenshot, der zeigt, wie Sie Eigenschaften in einem Datentipp anheften können.

  3. Um die Anheftung einer Eigenschaft in einem Datentipp aufzuheben, wählen Sie die Stecknadel für die Eigenschaft erneut aus, oder klicken Sie mit der rechten Maustaste auf die Eigenschaft und wählen Sie Anheften des Mitglieds als Favorit aufheben.

Sie können auch die Sichtbarkeit von Eigenschaftsnamen umschalten und nicht angeheftete Eigenschaften in der Eigenschaftsliste des Objekts in einem Datentipp herausfiltern:

  • Um nicht angeheftete Eigenschaften herauszufiltern, klicken Sie mit der rechten Maustaste auf die Eigenschaftszeile im Datentipp und wählen Sie Nur angeheftete Mitglieder anzeigen.

  • Um die Sichtbarkeit von Eigenschaftsnamen umzuschalten, klicken Sie mit der rechten Maustaste auf die Eigenschaftszeile im Datentipp und wählen Sie Namen angehefteter Mitglieder in Werten ausblenden.

Das folgende Image zeigt die verschiedenen Optionen des Rechtsklick-Menüs für die Mitgliederhierarchie in einem Datentipp:

Screenshot des Rechtsklick-Menüs für Mitglieder in einem Datentipp, das die Optionen

KI-Unterstützung

Wenn Sie Copilot haben, können Sie KI-Unterstützung erhalten, während Sie sich CPU-Erkenntnisse ansehen. Klicken Sie mit der rechten Maustaste auf eine Variable, und verwenden Sie die Schaltfläche Copilot fragen Screenshot der Schaltfläche Copilot fragen.. In diesem Szenario kennt Copilot bereits den Kontext für Ihre Frage, sodass Sie den Kontext nicht selbst im Chat angeben müssen. Weitere Informationen finden Sie unter Mit Copilot debuggen.

Visuelles Darstellen von komplexen Datentypen

Visualisierer stellen Informationen auf eine aussagekräftigere und manchmal auch grafische Weise dar. Beispiele für Visualisierungen sind XML, HTML, JSON und der Textvisualisierer. Sie können Visualisierer verwenden, um komplexe Datentypen in Ihrem Code während des Debuggens zu untersuchen.

Wenn Visualisierer für ein Element verfügbar sind, zeigt Visual Studio die Ansicht-Lupe neben dem Elementnamen im Datentipp an. Wenn Sie einen Visualisierer auswählen, öffnet Visual Studio ein separates Fenster, in dem die komplexen Daten in einem lesbaren Format angezeigt werden.

Sie können diese Funktion nutzen, um einen Visualisierer für Ihre Daten auszuwählen:

  • Um das Element mit dem Standard-Visualisierer für den Datentyp anzuzeigen, wählen Sie die Lupe. Symbol „Schnellansicht“

  • Um einen bestimmten Visualisierer auszuwählen, erweitern Sie die Dropdown-Liste Ansicht neben der Lupe und wählen Sie eine Option.

Variablen zu Überwachungsfenstern hinzufügen

Sie können Variablen weiterhin beobachten, indem Sie sie von einem Datentipp aus zu einem Visual Studio Überwachen-Fenster hinzufügen:

  • Klicken Sie im Datentipp mit der rechten Maustaste auf den Variablennamen und wählen Sie Überwachung hinzufügen.

Visual Studio fügt die Variable in das Fenster Überwachen ein. Wenn Ihre Visual Studio Edition mehrere Überwachungsfenster unterstützt, erscheint die Variable in dem Fenster mit der Bezeichnung Überwachung 1.

Importieren und Exportieren von DataTips

Sie können Datentipps in eine XML-Datei exportieren, die Sie weitergeben oder mit einem Texteditor bearbeiten können. Sie können Datentipps auch aus einer XML-Datei importieren, die Sie erhalten oder zuvor bearbeitet haben.

Um Datentipps zu exportieren, gehen Sie folgendermaßen vor:

  1. Wählen Sie in Visual Studio Debuggen>Datentipps exportieren. Das Dialogfeld Datentipps exportieren wird geöffnet.

  2. Navigieren Sie in dem Dialog zu dem Ort, an dem Sie die XML-Datei speichern möchten.

  3. Geben Sie einen Namen für die Exportdatei ein und wählen Sie Speichern.

Visual Studio exportiert Ihre Datentipps in die angegebene Datei und an den angegebenen Speicherort.

Um Datentipps aus einer Datei zu importieren, gehen Sie folgendermaßen vor:

  1. Wählen Sie in Visual Studio Debuggen>Datentipps importieren. Das Dialogfeld Datentipps importieren wird geöffnet.

  2. Suchen Sie im Dialogfeld nach dem Speicherort der XML-Datei mit den Datentipps, die Sie für den Import verwenden möchten.

  3. Wählen Sie die zu öffnende Datei aus und wählen Sie Öffnen.

Visual Studio importiert die Datentipps aus der angegebenen Datei in Ihren aktuellen Arbeitsbereich. Wenn Sie den Code des Arbeitsbereichs debuggen, sind die importierten Datentipps verfügbar.