goto

Leitet cmd.exe an eine bezeichnete Zeile in einem Batchprogramm weiter. Dieser Befehl leitet die Befehlsverarbeitung in einem Batchprogramm an eine Zeile weiter, die mit einer Bezeichnung gekennzeichnet ist. Wenn die Bezeichnung gefunden wird, startet die Verarbeitung mit den Befehlen, die in der nächsten Zeile beginnen.

Syntax

goto <label>

Parameter

Parameter BESCHREIBUNG
<label> Gibt eine Textzeichenfolge an, die im Batchprogramm als Bezeichnung verwendet wird.
/? Zeigt die Hilfe an der Eingabeaufforderung an.

Bemerkungen

  • Wenn Befehlserweiterungen aktiviert sind (Standardeinstellung) und Sie den goto-Befehl mit der Zielbezeichnung :EOF verwenden, übertragen Sie die Steuerung an das Ende der aktuellen Batchskriptdatei und beenden diese, ohne eine Bezeichnung zu definieren. Wenn Sie diesen Befehl einer Bezeichnung wie :EOF verwenden, müssen Sie vor der Bezeichnung einen Doppelpunkt einfügen. Beispiel: goto:EOF

  • Sie können Leerzeichen im Parameter label verwenden, aber keine anderen Trennzeichen wie z. B. das Semikolon (;) oder das Gleichheitszeichen (=).

  • Der von Ihnen angegebene Wert für label muss mit einer Bezeichnung im Batchprogramm übereinstimmen. Die Bezeichnung im Batchprogramm muss mit einem Doppelpunkt (:) beginnen. Wenn eine Zeile mit einem Doppelpunkt beginnt, wird sie als Bezeichnung behandelt, und alle Befehle in dieser Zeile werden ignoriert. Wenn Ihr Batchprogramm die von Ihnen im Parameter label angegebene Bezeichnung nicht enthält, wird das Batchprogramm beendet, und die folgende Meldung angezeigt: Label not found.

  • Sie können goto mit anderen Befehlen verwenden, um bedingte Vorgänge auszuführen. Weitere Informationen zur Verwendung von goto für bedingte Vorgänge finden Sie beim Befehl if.

Beispiele

Das folgende Batchprogramm formatiert einen Datenträger in Laufwerk A als Systemdatenträger. Wenn der Vorgang erfolgreich ist, leitet der Befehl goto die Verarbeitung an die Bezeichnung :end weiter:

echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.