choice

Chiede all'utente di selezionare un elemento da un elenco di scelte a caratteri singoli in un programma batch e quindi restituisce l'indice della scelta selezionata. Se utilizzato senza parametri, choice visualizza le scelte predefinite Y e N.

Syntax

choice [/c [<choice1><choice2><…>]] [/n] [/cs] [/t <timeout> /d <choice>] [/m <text>]

Parameters

Parameter Description
/c <choice1><choice2><…> Specifica l'elenco di scelte da creare. Le scelte valide includono caratteri a-z, A-Z, 0-9 e caratteri ASCII estesi (128-254). L'elenco predefinito è YN, visualizzato come [Y,N]?.
/n Nasconde l'elenco delle scelte, anche se le scelte sono ancora abilitate e il testo del messaggio (se specificato da /m) è ancora visualizzato.
/cs Specifica che le scelte fanno distinzione tra maiuscole e minuscole. Per impostazione predefinita, le scelte non fanno distinzione tra maiuscole e minuscole.
/t <timeout> Specifica il numero di secondi da sospendere prima di utilizzare la scelta predefinita specificata da /d. I valori accettabili sono compresi tra 0 e 9999. Se /t è impostato su 0, la scelta non viene sospesa prima di restituire la scelta predefinita.
/d <choice> Specifica la scelta predefinita da utilizzare dopo aver atteso il numero di secondi specificato da /t. La scelta predefinita deve essere inclusa nell'elenco di scelte specificato da /c.
/m <text> Specifica un messaggio da visualizzare prima dell'elenco di scelte. Se /m non viene specificato, viene visualizzato solo il prompt di scelta.
/? Visualizza la Guida al prompt dei comandi.

Remarks

  • La variabile di ambiente ERRORLEVEL è impostata sull'indice della chiave selezionata dall'utente dall'elenco delle scelte. La prima scelta nell'elenco restituisce un valore di 1, il secondo valore di 2e così via. Se l'utente preme un tasto che non è una scelta valida, la scelta emette un segnale acustico di avviso.

  • Se la scelta rileva una condizione di errore, restituisce un valore ERRORLEVEL di 255. Se l'utente preme CTRL+BREAK o CTRL+C, la scelta restituisce un valore ERRORLEVEL di 0.

Note

Quando si utilizzano i valori ERRORLEVEL in un programma batch, è necessario elencarli in ordine decrescente.

Examples

Per presentare le scelte Y, N e C, digitare la seguente riga in un file batch:

choice /c ync

Quando il file batch esegue il comando di scelta , viene visualizzato il seguente messaggio:

[Y,N,C]?

Per nascondere le opzioni Y, N e C, ma visualizzare il testo , No o Continua, digitare la seguente riga in un file batch:

choice /c ync /n /m "Yes, No, or Continue?"

Note

Se si utilizza il parametro /n , ma non si utilizza /m, all'utente non viene richiesto quando la scelta è in attesa di input.

Per visualizzare sia il testo che le opzioni usate negli esempi precedenti, digitare la riga seguente in un file batch:

choice /c ync /m "Yes, No, or Continue"

Per impostare un limite di tempo di cinque secondi e specificare N come valore predefinito, digitare la seguente riga in un file batch:

choice /c ync /t 5 /d n

Note

In questo esempio, se l'utente non preme un tasto entro cinque secondi, la scelta seleziona N per impostazione predefinita e restituisce un valore di errore di 2. In caso contrario, choice restituisce il valore corrispondente alla scelta dell'utente.