Freigeben über


choice

Fordert den Benutzer auf, ein Element aus einer Liste mit einstelligen Auswahlmöglichkeiten in einem Batchprogramm auszuwählen, und gibt dann den Index der ausgewählten Auswahl zurück. Wenn choice ohne Parameter verwendet wird, werden die Standardoptionen Y und N angezeigt.

Syntax

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

Parameters

Parameter Description
/c <choice1><choice2><…> Gibt die Liste der zu erstellenden Optionen an. Gültige Auswahlmöglichkeiten umfassen a-z, A-Z, 0-9 und erweiterte ASCII-Zeichen (128-254). Die Standardliste ist YN, die als [Y,N]?angezeigt wird.
/n Blendet die Liste der Auswahlmöglichkeiten aus, obwohl die Auswahlmöglichkeiten noch aktiviert sind und der Meldungstext (falls durch /m angegeben) weiterhin angezeigt wird.
/cs Gibt an, dass bei den Auswahlmöglichkeiten die Groß-/Kleinschreibung beachtet wird. Standardmäßig wird die Groß-/Kleinschreibung nicht beachtet.
/t <timeout> Gibt die Anzahl der Sekunden an, die angehalten werden soll, bevor die durch /d angegebene Standardauswahl verwendet wird. Zulässige Werte liegen zwischen 0 und 9999. Wenn /t auf 0 festgelegt ist, wird die Auswahl nicht angehalten, bevor die Standardauswahl zurückgegeben wird.
/d <choice> Gibt die Standardauswahl an, die nach dem Warten auf die von /t angegebene Anzahl von Sekunden verwendet werden soll. Die Standardauswahl muss sich in der Liste der Auswahlmöglichkeiten befinden, die durch /c angegeben werden.
/m <text> Gibt eine Meldung an, die vor der Auswahlliste angezeigt werden soll. Wenn /m nicht angegeben ist, wird nur die Auswahlaufforderung angezeigt.
/? Zeigt hilfe an der Eingabeaufforderung an.

Remarks

  • Die Umgebungsvariable ERRORLEVEL wird auf den Index des Schlüssels gesetzt, den der Benutzer aus der Liste der Auswahlmöglichkeiten auswählt. Die erste Auswahl in der Liste gibt einen Wert von 1, den zweiten einen Wert von 2usw. zurück. Wenn der Benutzer eine Taste drückt, bei der es sich nicht um eine gültige Auswahl handelt, ertönt ein Signalton.

  • Wenn choice eine Fehlerbedingung erkennt, gibt sie den ERRORLEVEL-Wert zurück 255. Wenn der Benutzer STRG+UNTBR oder STRG+C drückt, gibt choice den ERRORLEVEL-Wert zurück 0.

Note

Wenn Sie ERRORLEVEL-Werte in einem Batch-Programm verwenden, müssen Sie diese in absteigender Reihenfolge auflisten.

Examples

Um die Auswahlmöglichkeiten Y, N und C anzuzeigen, geben Sie die folgende Zeile in eine Batchdatei ein:

choice /c ync

Die folgende Eingabeaufforderung wird angezeigt, wenn die Batchdatei den Auswahlbefehl ausführt:

[Y,N,C]?

Wenn Sie die Auswahlmöglichkeiten Y, N und C ausblenden, aber den Text Ja, Nein oder Weiter anzeigen möchten, geben Sie die folgende Zeile in eine Batchdatei ein:

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

Note

Wenn Sie den Parameter /n , aber nicht /m verwenden, wird der Benutzer nicht aufgefordert, wenn die Auswahl auf eine Eingabe wartet.

Um sowohl den Text als auch die in den vorherigen Beispielen verwendeten Optionen anzuzeigen, geben Sie die folgende Zeile in eine Batchdatei ein:

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

Um ein Zeitlimit von fünf Sekunden festzulegen und N als Standardwert anzugeben, geben Sie die folgende Zeile in eine Batchdatei ein:

choice /c ync /t 5 /d n

Note

Wenn der Benutzer in diesem Beispiel innerhalb von fünf Sekunden keine Taste drückt, wählt choice standardmäßig N aus und gibt den Fehlerwert zurück 2. Andernfalls gibt choice den Wert zurück, der der Auswahl des Benutzers entspricht.