choice

  • Artikel

Fordert Benutzer*innen dazu auf, ein Element aus einer Liste von Einzelzeichenoptionen in einem Batchprogramm auszuwählen, und gibt anschließend den Index der ausgewählten Auswahl zurück. Bei Verwendung ohne Parameter zeigt choice die Standardoptionen Y und N an.

Syntax

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

Parameter

Parameter BESCHREIBUNG
/c <choice1><choice2><…> Gibt die Liste der zu erstellenden Optionen an. Gültige Auswahlmöglichkeiten sind 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 Auswahlliste aus, obwohl die Auswahlmöglichkeiten weiterhin aktiviert sind und der Meldungstext (sofern durch /m angegeben) weiterhin angezeigt wird.
/cs Gibt an, dass bei den Auswahlmöglichkeiten die Groß-/Kleinschreibung relevant ist. Standardmäßig wird die Groß-/Kleinschreibung bei der Auswahl nicht beachtet.
/t <timeout> Gibt die Anzahl von Sekunden an, die gewartet werden soll, bevor die durch /d angegebene Standardauswahl verwendet wird. Zulässige Werte reichen von 0 bis 9999. Wenn /t auf 0 festgelegt ist, wartet choice nicht ab und gibt sofort die Standardauswahl zurück.
/d <choice> Gibt die Standardauswahl an, die nach dem Abwarten der durch /t angegebenen Anzahl von Sekunden verwendet werden soll. Die Standardauswahl muss in der durch /c angegebenen Liste der Optionen enthalten sein.
/m <text> Gibt eine Meldung an, die vor der Auswahlliste angezeigt werden soll. Wenn /m nicht angegeben ist, wird nur die Auswahlaufforderung angezeigt.
/? Zeigt die Hilfe an der Eingabeaufforderung an.

Bemerkungen

  • Die ERRORLEVEL-Umgebungsvariable wird auf den Index der Taste festgelegt, die der Benutzer aus der Auswahlliste auswählt. Die erste Auswahl in der Liste gibt den Wert 1, die zweite den Wert 2 zurück usw. Wenn Benutzer*innen eine Taste drücken, die keiner gültigen Auswahl entspricht, löst choice einen Warnsignalton aus.

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

Hinweis

Wenn Sie ERRORLEVEL-Werte in einem Batchprogramm verwenden, müssen Sie sie in abnehmender Reihenfolge auflisten.

Beispiele

Geben Sie die folgende Zeile in eine Batchdatei ein, um die Optionen Y, N und C anzuzeigen:

choice /c ync

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

[Y,N,C]?

Um die Optionen Y, N und C auszublenden und stattdessen den Text Yes, No oder Continue anzuzeigen, geben Sie die folgende Zeile in eine Batchdatei ein:

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

Hinweis

Wenn Sie den Parameter /n, aber nicht /m verwenden, werden Benutzer*innen nicht zur Eingabe aufgefordert, wenn choices auf eine Eingabe wartet.

Um sowohl den in den vorherigen Beispielen verwendeten Text als auch die 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

Hinweis

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