Exportar (0) Imprimir
Expandir Tudo
Arp
At
Cd
Cls
Cmd
Del
Dir
Fc
For
Ftp
If
Ldp
Lpq
Lpr
Md
Mmc
Msg
Nlb
Rcp
Rd
Reg
Rem
Ren
Rsh
Rsm
Rss
Sc
Set
Sfc
Ver
Vol
Expandir Minimizar
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Escolha

Solicita ao usuário selecionar um item de uma lista de opções de caractere único em um programa em lotes e retorna o índice da opção selecionada. Se usado sem parâmetros, opção exibe as opções padrão y e N.

Para obter exemplos de como usar esse comando, consulte exemplos.

Sintaxe



Choice [/c [<Choice1> <Choice2> <…>]] [/n] [/cs] [/t <Timeout>/d <Choice>] [/m < "Text" >]

Parâmetros

Parâmetro Descrição

/c <Choice1> <Choice2> <…>

Especifica a lista de opções a serem criados. As opções válidas incluem a-z, A-Z, 0-9 e caracteres ASCII estendidos (128-254). A lista padrão é "YN", que é exibido como [Y,N]? .

/n

Oculta a lista de opções, embora as opções ainda estão ativadas e o texto da mensagem (se especificado pelo /m) ainda é exibido.

/CS

Especifica as opções são diferencia maiúsculas de minúsculas. Por padrão, as opções não diferenciam maiúsculas de minúsculas.

/t <Timeout>

Especifica o número de segundos de pausa antes de usar a opção padrão especificada pelo /d. Valores aceitáveis são de 0 a 9999. Se /t é definido como 0, choice não pausa antes de retornar a opção padrão.

/d <Choice>

Especifica a opção padrão para usar após esperar o número de segundos especificado por /t. Deve ser a opção padrão na lista de opções especificadas por /c.

/m < "text" >

Especifica uma mensagem para exibir antes de lista de opções. Se /m não for especificado, somente o prompt de escolha é exibido.

/?

Exibe a Ajuda no prompt de comando.

Comentários

  • A variável de ambiente ERRORLEVEL é definida para o índice da chave que o usuário seleciona na lista de opções. A primeira opção na lista retorna um valor de 1, o segundo um valor 2 e assim por diante. Se o usuário pressiona uma tecla que não é uma opção válida, Escolha emitirá um aviso sonoro. Se a opção detectar uma condição de erro, ele retorna um valor ERRORLEVEL de 255. Se o usuário pressionar CTRL + BREAK ou CTRL + C, Escolha retorna um valor ERRORLEVEL 0.

Cc732504.note(pt-br,WS.10).gif Observação
Quando você usar valores ERRORLEVEL de um programa em lote, lista-los em ordem decrescente.

Exemplos

Para apresentar as opções C, N e Y, digite a seguinte linha em um arquivo em lotes:



choice /c snp

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



[Y, N, C]?

Para ocultar as opções C, N e Y, mas exibir o texto "Sim, não ou continuar", digite a seguinte linha em um arquivo em lotes:



choice /c snp /n /m "Sim, não ou continuar?"

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



Sim, não ou prosseguir?

Cc732504.note(pt-br,WS.10).gif Observação
Se você usa o parâmetro /n , mas não use /m, o usuário não é solicitado quando a opção está aguardando entrada.

Para mostrar o texto e as opções usadas nos exemplos anteriores, digite a seguinte linha em um arquivo em lotes:



choice /c snp /m "Sim, não ou continuar"

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



Sim, não ou prosseguir [S, N, C]?

Para definir um limite de tempo de cinco segundos e especificar n como valor padrão, digite a seguinte linha em um arquivo em lotes:



choice /c snp /t 5 /d n

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



[Y, N, C]?

Cc732504.note(pt-br,WS.10).gif Observação
Neste exemplo, se o usuário não pressionar uma tecla dentro de cinco segundos, a opção seleciona n por padrão e retorna um valor de erro de 2. Caso contrário, a opção retorna o valor correspondente à opção do usuário.

Referências adicionais

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft