Compartilhar via

Goto

Direciona cmd.exe para uma linha rotulada em um programa em lotes. Em um programa em lotes, esse comando direciona o processamento de comando 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 lote.
/? 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ê transferirá o controle para o final do arquivo de script do lote atual e sairá do arquivo de script em lotes sem definir um rótulo. Ao usar 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 parâmetro rótulo, mas não pode incluir outros separadores (por exemplo, ponto e vírgula (;) ou sinais de igual (=)).

  • O rótulo valor que você especificar deve corresponder a um rótulo no programa em lote. O rótulo dentro do programa em lotes 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 lotes não contiver o rótulo especificado no rótulo parâmetro, o programa em lote será interrompido e exibirá 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 se o comando.

Exemplos

O programa em lote a seguir 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.