Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Monituje użytkownika o wybranie jednego elementu z listy opcji jednoznakowych w programie wsadowym, a następnie zwraca indeks wybranego wyboru. Jeśli nie określono parametrów, wybór wyświetla domyślne opcje Y i N.
Składnia
choice [/c [<choice1><choice2><…>]] [/n] [/cs] [/t <timeout> /d <choice>] [/m <text>]
Parametry
| Parametr | Opis |
|---|---|
/c <choice1><choice2><…> |
Określa listę opcji do utworzenia. Prawidłowe opcje obejmują znaki a-z, A-Z, 0-9 i rozszerzone znaki ASCII (128-254). Domyślna lista to YN, która jest wyświetlana jako [Y,N]?. |
| /n | Ukrywa listę opcji, chociaż opcje są nadal włączone, a tekst wiadomości (jeśli określono przez /m) jest nadal wyświetlany. |
| /Cs | Określa, że opcje są uwzględniane w wielkości liter. Domyślnie opcje nie są uwzględniane w wielkości liter. |
/t <timeout> |
Określa liczbę sekund do wstrzymania przed użyciem domyślnego wyboru określonego przez /d. Dopuszczalne wartości to od 0 do 9999. Jeśli /t jest ustawiona na 0, wybór nie zostanie wstrzymany przed zwróceniem wyboru domyślnego. |
/d <choice> |
Określa domyślny wybór do użycia po odczekaniu liczby sekund określonych przez /t. Wybór domyślny musi znajdować się na liście opcji określonych przez /c. |
/m <text> |
Określa komunikat do wyświetlenia przed listą opcji. Jeśli nie określono /m, zostanie wyświetlony tylko monit wyboru. |
| /? | Wyświetla pomoc w wierszu polecenia. |
Uwagi
Zmienna środowiskowa ERRORLEVEL jest ustawiona na indeks klucza wybranego przez użytkownika z listy opcji. Pierwszy wybór na liście zwraca wartość
1, drugą wartość2itd. Jeśli użytkownik naciśnie, który nie jest prawidłowym wyborem, wybór brzmi sygnał ostrzegawczy.Jeśli wybór wykryje warunek błędu, zwraca wartość ERRORLEVEL
255. Jeśli użytkownik naciśnie CTRL+BREAK lub CTRL+C, wybór zwraca wartość ERRORLEVEL0.
Uwaga
W przypadku używania wartości ERRORLEVEL w programie wsadowym należy je wyświetlić w kolejności malejącej.
Przykłady
Aby przedstawić opcje Y, Ni C, wpisz następujący wiersz w pliku wsadowym:
choice /c ync
Podczas uruchamiania pliku wsadowego wybranego polecenia zostanie wyświetlony następujący monit:
[Y,N,C]?
Aby ukryć opcje Y, Ni C, ale wyświetl tekst Tak, Nielub Kontynuuj, wpisz następujący wiersz w pliku wsadowym:
choice /c ync /n /m "Yes, No, or Continue?"
Uwaga
Jeśli używasz parametru /n, ale nie używaj /m, użytkownik nie jest monitowany, gdy wybór oczekuje na dane wejściowe.
Aby wyświetlić tekst i opcje używane w poprzednich przykładach, wpisz następujący wiersz w pliku wsadowym:
choice /c ync /m "Yes, No, or Continue"
Aby ustawić limit czasu pięciu sekund i określić N jako wartość domyślną, wpisz następujący wiersz w pliku wsadowym:
choice /c ync /t 5 /d n
Uwaga
W tym przykładzie, jeśli użytkownik nie naciska w ciągu pięciu sekund, wybór wybiera N domyślnie i zwraca wartość błędu 2. W przeciwnym razie wybór zwraca wartość odpowiadającą wyborowi użytkownika.