C#應用程式

從使用者請求資料 - Spectre Console 系列

Tim Corey

10m 10s

C# 控制台應用程式一直以來都是學習程式如何從使用者讀取輸入並顯示輸出的最簡單方式。在他的 Spectre.Console 系列中，Tim Corey 展示了如何超越單調的黑白指令提示字元。在本文中，我們將仔細看看他的影片"Requesting Data from the User - Spectre Console Series"，了解他如何收集輸入、處理數值、進行錯誤檢查，並提升程式的友好性 - 所有這些都不需要手動修改模板程式碼。包含時間戳記，方便您跳到影片的正確位置。

簡介：使指令行輸入更簡單

一開始，Tim 提醒我們 Spectre.Console 可以將普通的 C 指令行輸入轉變為視覺上更吸引人的東西。不必撰寫完整的 static void Main(string[] args) 方法，然後手動從標準輸入流 Console.ReadLine() 讀取、解析處理，並處理異常，Spectre.Console 為您封裝了一切。

用 Tim 的話說（0:17），本次會議將展示如何"向使用者詢問輸入、驗證資料，並將其轉換成合適的資料型別"——這是任何開發者使用控制台或命令提示符的核心技能。

使用 Ask 讀取整數值

Tim 的第一個例子（0:35）是個很熟悉的例子：詢問使用者的年齡。傳統的 C# 語法是這樣的：

static void Main(string[] args)
{
    Console.Write("Enter integer age: ");
    string input = Console.ReadLine();
    int age = int.Parse(input);
}

static void Main(string[] args)
{
    Console.Write("Enter integer age: ");
    string input = Console.ReadLine();
    int age = int.Parse(input);
}

Sub Main(ByVal args As String())
    Console.Write("Enter integer age: ")
    Dim input As String = Console.ReadLine()
    Dim age As Integer = Integer.Parse(input)
End Sub

Sub Main(ByVal args As String())
    Console.Write("Enter integer age: ")
    Dim input As String = Console.ReadLine()
    Dim age As Integer = Integer.Parse(input)
End Sub

這展示了 C# 程式的經典入口點，主函式，以及如何通過控制台從鍵盤接收一個輸入參數。您還必須使用 int.Parse 或 Convert.ToInt32 將字元串輸入轉換為 int 型別的年齡。 Tim 指出，您必須自行處理無效輸入並拋出或捕獲異常。

在 Spectre.Console 中，他只需寫一行：

int age = AnsiConsole.Ask<int>("What is your age?");

int age = AnsiConsole.Ask<int>("What is your age?");

Dim age As Integer = AnsiConsole.Ask(Of Integer)("What is your age?")

Dim age As Integer = AnsiConsole.Ask(Of Integer)("What is your age?")

這一行讀取輸入，將其轉換為整數值，並在使用者輸入非數字字元時顯示紅色錯誤消息，不需要額外的錯誤檢查程式碼。當使用者按下 Enter 鍵時，方法讀取輸入，解析為數字型別，並將其儲存在年齡變數中。

布林輸入及為何 Prompt 更好

接下來（1:14） Tim 示範詢問布林值：

bool isHappy = AnsiConsole.Ask<bool>("Are you happy?");

bool isHappy = AnsiConsole.Ask<bool>("Are you happy?");

Dim isHappy As Boolean = AnsiConsole.Ask(Of Boolean)("Are you happy?")

Dim isHappy As Boolean = AnsiConsole.Ask(Of Boolean)("Are you happy?")

如果使用者輸入"true"或"false"，就能正常運作。但如果他們輸入"yes"，Spectre.Console 會顯示一個紅色錯誤。這顯示了雖然 Ask<bool> 能自動處理資料型別，但對於使用者輸入來說並不總是最自然的。

這就是 Tim 轉向更靈活的 API——Prompt 的地方，這更像是一個您可以自定義的小類別。

使用 TextPrompt 進行選擇

在 3:02 時，Tim 從 Ask 換成 Prompt，使用 TextPrompt<string>。他不使用內建的布林值，而是建立了一個新的文字提示實例，給使用者提供實際選擇：

var happyText = AnsiConsole.Prompt(
    new TextPrompt<string>("Are you happy?")
        .AddChoice("Yes")
        .AddChoice("No"));

var happyText = AnsiConsole.Prompt(
    new TextPrompt<string>("Are you happy?")
        .AddChoice("Yes")
        .AddChoice("No"));

Dim happyText = AnsiConsole.Prompt(
    New TextPrompt(Of String)("Are you happy?").
    AddChoice("Yes").
    AddChoice("No"))

Dim happyText = AnsiConsole.Prompt(
    New TextPrompt(Of String)("Are you happy?").
    AddChoice("Yes").
    AddChoice("No"))

當程式執行時（4:48），控制台在問題後面顯示 [Yes/No]。這是 Spectre.Console 美化命令行，使使用者可以輕鬆看到可接受的答案。如果您輸入其他任何內容，方法將收到它，並將其與列表進行比對，然後顯示一條友好的消息，告訴您選擇一個可用的選項。

新增預設值

Tim 接著新增了一個預設值（5:16）：

.DefaultValue("Yes")

.DefaultValue("Yes")

.DefaultValue("Yes")

.DefaultValue("Yes")

現在，當程式運行時，使用者只需按 Enter 鍵 - 沒有文字的回車 - 方法會自動為變數分配 "Yes"。這在您希望儲存合理預設而不需要在主方法中新增額外程式碼時效果很好。

使用驗證提示整數

在 6:01，Tim 展示了一個更豐富的整數輸入範例。他使用新的 TextPrompt 再次詢問年齡，但在提示中新增了驗證邏輯：

int age = AnsiConsole.Prompt(
    new TextPrompt<int>("What is your age?")
        .Validate(x =>
        {
            return x switch
            {
                < 0   => ValidationResult.Error("[red]You were not born yet[/]"),
                > 120 => ValidationResult.Error("[red]You are too old[/]"),
                _     => ValidationResult.Success(),
            };
        }));

int age = AnsiConsole.Prompt(
    new TextPrompt<int>("What is your age?")
        .Validate(x =>
        {
            return x switch
            {
                < 0   => ValidationResult.Error("[red]You were not born yet[/]"),
                > 120 => ValidationResult.Error("[red]You are too old[/]"),
                _     => ValidationResult.Success(),
            };
        }));

Dim age As Integer = AnsiConsole.Prompt(
    New TextPrompt(Of Integer)("What is your age?").Validate(Function(x)
        Select Case x
            Case Is < 0
                Return ValidationResult.Error("[red]You were not born yet[/]")
            Case Is > 120
                Return ValidationResult.Error("[red]You are too old[/]")
            Case Else
                Return ValidationResult.Success()
        End Select
    End Function))

Dim age As Integer = AnsiConsole.Prompt(
    New TextPrompt(Of Integer)("What is your age?").Validate(Function(x)
        Select Case x
            Case Is < 0
                Return ValidationResult.Error("[red]You were not born yet[/]")
            Case Is > 120
                Return ValidationResult.Error("[red]You are too old[/]")
            Case Else
                Return ValidationResult.Success()
        End Select
    End Function))

這裡提示不僅將字串值從標準輸入流轉換為數字型別，還基於業務規則進行錯誤檢查——如不允許負數值年齡。 Tim 現場測試（8:31）：輸入 -1 觸發"您尚未出生。"輸入 150 觸發"您太老了。"只有有效的輸入才能讓程式繼續執行下一行。

這內建的驗證消除了在主函式中手動撰寫 if 語句，調用解析方法和處理異常的需要。

Ask vs Prompt：何時使用

在 9:00，Tim 進行總結：

Ask：快速、簡單。當程式只需要讀取一個輸入參數並將其轉換為已知型別時，是完美的選擇。
Prompt：更強大。允許您新增選擇、預設值和驗證。在構建更加豐富的控制台應用程式或整合其他透過命令行參數調用您的可執行檔案的程式時非常好用。

這兩種方法仍然可以很好地融入到您的 static void Main(string[] args) 或 public static void Main(string[] args) 入口點中。您還可以存取 args 以讀取程式執行時傳遞的命令行參數，將其與 Spectre.Console 提示結合，並使用 string.Format 或插值輸出格式化的字串。