Direktfenster

Artikel
06/19/2023

Das Direktfenster wird zum Debuggen und Auswerten von Ausdrücken, Ausführen von Anweisungen und Ausgeben von Variablenwerten verwendet. Mit dem Direktfenster werden Ausdrücke durch Erstellen und Verwenden des derzeit ausgewählten Projekts ausgewertet.

Um das Fenster Direkt anzuzeigen, öffnen Sie ein Projekt zur Bearbeitung und wählen dann Debuggen>Windows>Direkt oder drücken STRG+ALT+I. Alternativ können Sie auch im BefehlsfensterDebug.Immediate eingeben.

Das Direktfenster unterstützt IntelliSense.

Anzeigen der Werte von Variablen

Das Direktfenster ist besonders beim Debuggen einer App nützlich. Um beispielsweise den Wert der Variablen varA zu überprüfen, können Sie den Print-Befehl verwenden:

>Debug.Print varA

Das Fragezeichen (?) ist ein Alias für Debug.Print, sodass dieser Befehl auch wie folgt eingegeben werden kann:

? varA

Beide Versionen dieses Befehls geben den Wert der Variablen varA zurück.

Tipp

Wenn Sie einen Visual Studio-Befehl im Fenster Direkt ausgeben, müssen Sie dem Befehl ein Größer-als-Zeichen (>) voranstellen. Wechseln Sie zum Befehlsfenster, wenn Sie mehrere Befehle eingeben möchten.

Ausdrucksauswertung zur Entwurfszeit

Sie können das Fenster Direkt verwenden, um eine Funktion oder Unterroutine zur Entwurfszeit auszuführen.

Ausführen einer Funktion zur Entwurfszeit

Kopieren Sie den folgenden Code, und fügen Sie ihn in eine Visual Basic-Konsolenanwendung ein:

Module Module1

    Sub Main()
        MyFunction(5)
    End Sub

    Function MyFunction(ByVal input as Integer) As Integer
        Return input * 2
    End Function

End Module

Klicken Sie im Menü Debuggen auf Windows>Direkt.
Geben Sie ?MyFunction(2) im Fenster Direkt ein, und drücken Sie die EINGABETASTE.

Über das Fenster Direkt wird MyFunction ausgeführt und 4 angezeigt.

Wenn die Funktion oder die Unterroutine einen Breakpoint enthält, unterbricht Visual Studio die Ausführung an der entsprechenden Stelle. Sie können dann die Debuggerfenster verwenden, um den Programmzustand zu überprüfen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Debugging at Design Time (Exemplarische Vorgehensweise: Debuggen zur Entwurfszeit).

Die Ausdrucksauswertung zur Entwurfszeit ist nicht für Projekttypen verfügbar, die das Starten einer Ausführungsumgebung erfordern, z.B. Visual Studio-Tools für Office-Projekte, Webprojekte, Projekte für intelligente Geräte und SQL-Projekte.

Ausdrucksauswertung zur Entwurfszeit in Projektmappen mit mehreren Projekten

Beim Festlegen des Kontexts für die Ausdrucksauswertung zur Entwurfszeit verweist Visual Studio auf das aktuell ausgewählte Projekt im Projektmappen-Explorer. Wenn im Projektmappen-Explorer kein Projekt ausgewählt ist, versucht Visual Studio, die Funktion anhand des Startprojekts auszuwerten. Wenn die Funktion im aktuellen Kontext nicht ausgewertet werden kann, wird eine Fehlermeldung angezeigt. Wenn Sie versuchen, eine Funktion in einem Projekt auszuwerten, das nicht das Startprojekt für die Projektmappe ist, und eine Fehlermeldung angezeigt wird, wählen Sie das Projekt im Projektmappen-Explorer aus, und wiederholen Sie die Auswertung.

Eingeben von Befehlen

Sie müssen das Größer-als-Zeichen (>) eingeben, wenn Sie Visual Studio-Befehle im Fenster Direkt angeben. Verwenden Sie die NACH-OBEN- und NACH UNTEN-TASTEN, um durch Ihre zuvor verwendeten Befehle zu scrollen.

Aufgabe	Lösung	Beispiel
Auswerten eines Ausdrucks.	Stellen Sie dem Ausdruck ein Fragezeichen (?) voran.	`? a+b`
Vorübergehendes Wechseln vom Direktmodus in den Befehlsmodus (zum Ausführen eines einzelnen Befehls).	Geben Sie den Befehl ein, und stellen Sie ihm ein Größer-als-Zeichen (>) voran.	`>alias`
Wechseln Sie zum Befehlsfenster.	Geben Sie im Fenster `cmd` ein, und stellen Sie dem Befehl ein Größer-als-Zeichen (>) voran.	`>cmd`
Wechseln Sie wieder zum Direktfenster.	Geben Sie in das Fenster `immed` ohne das Größer-als-Zeichen (>) ein.	`immed`

Markierungsmodus

Wenn Sie im Fenster Direkt auf eine zuvor ausgegebene Zeile klicken, schalten Sie automatisch in den Markierungsmodus um. Auf diese Weise können Sie den Text vorheriger Befehle wie in einem beliebigen anderen Text-Editor markieren, bearbeiten, kopieren und in die aktuelle Zeile einfügen.

Beispiele

Im folgenden Beispiel werden vier Ausdrücke und die dazugehörigen Ergebnisse im Direktfenster für ein Visual Basic-Projekt veranschaulicht.

j = 2
Expression has been evaluated and has no value

? j
2

j = DateTime.Now.Day
Expression has been evaluated and has no value

? j
26

Ausnahmebenachrichtigungen (erste Chance)

Bei einigen Einstellungskonfigurationen werden Ausnahmebenachrichtigungen (erste Chance) im Fenster Direkt angezeigt.

Ein- bzw. Ausblenden von Ausnahmebenachrichtigungen (erste Chance) im Fenster „Direkt“

Klicken Sie im Menü Ansicht auf Weitere Fenster und dann auf Ausgabe.
Klicken Sie mit der rechten Maustaste auf den Textbereich des Ausgabefensters, und aktivieren bzw. deaktivieren Sie dann die Option Ausnahmemeldungen.

Freigeben über