goto

  • Article

Dirige cmd.exe vers une ligne étiquetée dans un programme de traitement par lots. Dans un programme de traitement par lots, cette commande dirige le traitement des commandes vers une ligne identifiée par une étiquette. Lorsque l’étiquette est trouvée, le traitement se poursuit en commençant par les commandes qui commencent sur la ligne suivante.

Syntaxe

goto <label>

Paramètres

Paramètre Description
<label> Spécifie une chaîne de texte utilisée comme étiquette dans le programme de traitement par lots.
/? Affiche l'aide à l'invite de commandes.

Notes

  • Si les extensions de commande sont activées (valeur par défaut) et que vous utilisez la commande goto avec une étiquette cible :EOF, vous transférez le contrôle à la fin du fichier de script batch actuel et quittez le fichier de script de lot sans définir d’étiquette. Lorsque vous utilisez cette commande avec l’étiquette :EOF, vous devez insérer un signe deux-points avant l’étiquette. Par exemple : goto:EOF.

  • Vous pouvez utiliser des espaces dans le paramètre étiquette, mais vous ne pouvez pas inclure d’autres séparateurs (par exemple, des points-virgules (;) ou des signes égaux (=)).

  • La valeur d’étiquette que vous spécifiez doit correspondre à une étiquette dans le programme de traitement par lots. L’étiquette dans le programme de traitement par lots doit commencer par un signe deux-points (:). Si une ligne commence par un signe deux-points, elle est traitée comme une étiquette et toutes les commandes sur cette ligne sont ignorées. Si votre programme de traitement par lots ne contient pas l’étiquette que vous spécifiez dans le paramètre étiquette, le programme de traitement par lots s’arrête et affiche le message suivant : Label not found.

  • Vous pouvez utiliser goto avec d’autres commandes pour effectuer des opérations conditionnelles. Pour plus d’informations sur l’utilisation de goto pour les opérations conditionnelles, consultez la commande if.

Exemples

Le programme de commandes suivant met en forme un disque dans le lecteur A en tant que disque système. Si l’opération réussit, la commande goto dirige le traitement vers l’étiquette :end :

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