scelta

Richiede all'utente di selezionare un elemento da un elenco di scelte a carattere singolo in un file batch e quindi restituisce l'indice dell'opzione selezionata. Se utilizzata senza parametri, scelta consente di visualizzare le scelte predefinite Y e N.

Sintassi

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

Parametri

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

Osservazioni:

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

  • Se choice rileva una condizione di errore viene restituito un valore ERRORLEVEL di 255. Se l'utente preme choice restituisce un valore ERRORLEVEL di 0.

Nota

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

Esempi

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

choice /c ync

Il seguente messaggio viene visualizzato quando il file batch viene eseguito il scelta comando:

[Y,N,C]?

Per nascondere le proprie scelte Y, N, e C, ma visualizzare il testo Yes, No, or Continue, digitare la riga seguente in un file batch:

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

Nota

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

Per visualizzare testo e le opzioni utilizzate negli esempi precedenti, digitare la riga seguente in un file batch:

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

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

choice /c ync /t 5 /d n

Nota

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