提示使用者從批次程式中的單一字元選擇清單中選取一個專案,然後傳回所選取一個項目,然後傳回所選取選項的索引。 如果沒有參數使用,選擇 會顯示預設選項 Y 和 N。
語法
choice [/c [<choice1><choice2><…>]] [/n] [/cs] [/t <timeout> /d <choice>] [/m <text>]
參數
參數 | 說明 |
---|---|
/c <choice1><choice2><…> |
指定要建立的選項清單。 有效選項包括 a-z、A-Z、0-9 和擴充 ASCII 字元(128-254)。 默認清單為 YN,會顯示為 [Y,N]? 。 |
/n | 隱藏選項清單,不過仍然啟用選項,而且仍會顯示消息正文(如 /m所指定)。 |
/cs | 指定選項區分大小寫。 根據預設,選擇不會區分大小寫。 |
/噸 <timeout> |
指定要暫停的秒數,再使用 /d所指定的預設選擇。 可接受的值為從 0 到 9999。 如果 /t 設定為 0,則 選擇 在傳回預設選擇之前不會暫停。 |
/d <choice> |
指定在等候 /t /t 所指定秒數之後使用的預設選擇,。 預設選項必須位於 /c 所指定的選項清單中,。 |
/米 <text> |
指定要在選擇清單之前顯示的訊息。 如果未指定 /m,則只會顯示選擇提示。 |
? | 在命令提示字元中顯示說明。 |
備註
ERRORLEVEL 環境變數會設定為使用者從選擇清單中選取的索引鍵索引。 清單中的第一個選項會傳回
1
值、第二個值為2
等等。 如果使用者按下不是有效選項的按鍵,選擇 發出警告嗶聲。如果 選擇 偵測到錯誤狀況,則會傳回
255
值。 如果使用者按下 CTRL+BREAK 或 CTRL+C,選擇 會傳回0
值。
備註
當您在批次程式中使用 ERRORLEVEL 值時,您必須依遞減順序列出它們。
範例
若要呈現 Y、N和 C的選項,請在批次處理檔中輸入下列行:
choice /c ync
當批次處理檔執行 選擇 命令時,會出現下列提示:
[Y,N,C]?
若要隱藏 Y、N和 C的選項,但在批處理檔中輸入下列行 [是]、[]、[否] 或 [繼續 ]輸入下列行:
choice /c ync /n /m "Yes, No, or Continue?"
備註
如果您使用 /n 參數,但請勿使用 /m,則 選擇 等候輸入時,不會提示使用者。
若要同時顯示上述範例中使用的文字和選項,請在批次處理檔中輸入下列這一行:
choice /c ync /m "Yes, No, or Continue"
若要設定五秒的時間限制,並將 N 指定為預設值,請在批次處理檔中輸入下列這一行:
choice /c ync /t 5 /d n
備註
在這裡範例中,如果使用者未在五秒內按下按鍵,選擇 預設會選取 N,並傳回錯誤值 2
。 否則,選擇 會傳回對應至用戶選擇的值。