Partilhar via

goto

Direciona cmd.exe para uma linha rotulada em um programa em lote. Dentro de um programa em lotes, esse comando direciona o processamento de comandos para uma linha identificada por um rótulo. Quando o rótulo é encontrado, o processamento continua começando com os comandos que começam na próxima linha.

Sintaxe

goto <label>

Parâmetros

Parâmetro Descrição
<label> Especifica uma cadeia de caracteres de texto que é usada como um rótulo no programa em lotes.
/? Exibe a ajuda no prompt de comando.

Observações

  • Se as extensões de comando estiverem habilitadas (o padrão) e você usar o comando goto com um rótulo de destino de :EOF, você transfere o controle para o final do arquivo de script em lote atual e sai do arquivo de script em lote sem definir um rótulo. Quando você usa esse comando com o rótulo :EOF, você deve inserir dois pontos antes do rótulo. Por exemplo: goto:EOF.

  • Você pode usar espaços no rótulo parâmetro, mas não pode incluir outros separadores (por exemplo, ponto-e-vírgula (;) ou sinais de igual (=)).

  • O rótulo valor especificado deve corresponder a um rótulo no programa em lotes. O rótulo dentro do programa de lote deve começar com dois pontos (:). Se uma linha começar com dois pontos, ela será tratada como um rótulo e todos os comandos nessa linha serão ignorados. Se o programa em lote não contiver o rótulo especificado no parâmetro rótulo, o programa em lote para e exibe a seguinte mensagem: Label not found.

  • Você pode usar goto com outros comandos para executar operações condicionais. Para obter mais informações sobre como usar goto para operações condicionais, consulte o comando if.

Exemplos

O seguinte programa em lote formata um disco na unidade A como um disco do sistema. Se a operação for bem-sucedida, o comando goto direcionará o processamento para o rótulo :end:

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