共用方式為


教學課程:使用 Visual Studio Code 建立 .NET 主控台應用程式

本教學課程說明如何使用 Visual Studio Code 與 .NET CLI 建立及執行 .NET 主控台應用程式。 使用 .NET CLI 可以完成建立、編譯、執行專案等專案工作。 如有需要,您可以使用不同程式碼編輯器遵循本教學課程,並在終端機中執行命令。

必要條件

建立 應用程式

建立名為 "HelloWorld" 的 .NET 主控台應用程式專案。

  1. 啟動 Visual Studio Code。

  2. 在主要功能表中依序點選 [檔案] > [開啟資料夾] (在 macOS 上請依序點選 [檔案] > [開啟...])。

  3. 在 [開啟資料夾] 對話方塊中建立 [HelloWorld] 資料夾並加以選取。 接著按一下 [選取資料夾] (在 macOS 上請按一下 [開啟])。

    資料夾名稱會預設為專案名稱和命名空間名稱。 您稍後在教學課程中會新增程式碼,專案命名空間假設為 HelloWorld

  4. 在 [您是否信任此資料夾中檔案的作者?] 對話方塊中,選取 [是,我信任作者]。 您可以信任作者,因為此資料夾只有 .NET 產生的檔案,並由您新增或修改。

  5. 在主要功能表內選取 [檢視]>[終端],便能於 Visual Studio Code 中開啟 [終端]

    終端會與命令提示字元一起在「HelloWorld」資料夾中開啟。

  6. 終端中輸入下列命令:

    dotnet new console --framework net8.0 --use-program-main
    

    開啟 Program.cs 檔案,以查看範本所建立的簡單應用程式:

    namespace HelloWorld;
    
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello, World!");
        }
    }
    

    第一次開啟「.cs」檔案時,Visual Studio Code 會提示您新增資產,以建置應用程式並加以偵錯。 選取 [是],Visual Studio Code 便會建立含有 launch.json 與 tasks.json 檔案的 [.vscode] 資料夾。

    注意

    如果您沒有收到提示,或者尚未選取 [是] 就不小心關閉提示,請按照下列步驟建立 launch.jsontasks.json 檔案:

    • 在功能表中選取 [執行] > [新增設定]。
    • 在[選取環境] 提示中選取 .NET 5+ and .NET Core

    此程式碼會定義 Program 類別,其中包含單一方法 Main,會將 String 陣列作為引數。 Main 是應用程式進入點,是執行階段在啟動應用程式時會自動呼叫的方法。 在應用程式啟動時所提供的所有命令列引數,都會在 args 陣列中提供。 Main 中的程式碼會呼叫 Console.WriteLine(String) 方法來在主控台視窗中顯示訊息。

    C# 具有名為最上層陳述式的功能,可讓您省略 Program 類別和 Main 方法。 本教學課程不會使用這項功能。 您可按風格偏好選擇是否在您的程式中使用。 在建立專案的 dotnet new 命令中,--use-program-main 選項會禁止使用最上層陳述式。

執行應用程式

終端執行下列命令:

dotnet run

程式會顯示「Hello, World!」,然後結束。

The dotnet run command

增強應用程式

增強應用程式後,便可提示使用者輸入其名稱,並與日期和時間一併顯示。

  1. 開啟 Program.cs

  2. 在 Program.cs 中以下列程式碼取代 Main 方法的內容 (即呼叫 Console.WriteLine 的那一行):

    Console.WriteLine("What is your name?");
    var name = Console.ReadLine();
    var currentDate = DateTime.Now;
    Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
    Console.Write($"{Environment.NewLine}Press any key to exit...");
    Console.ReadKey(true);
    

    此程式碼會在主控台視窗中顯示提示,然後等待使用者輸入字串並按下 Enter 鍵。 程式碼會將此字串儲存在名為 name 的變數中, 此程式碼也會擷取 DateTime.Now 屬性的值,其中包含目前的當地時間,並將它指派至名稱為 currentDate 的變數。 並在主控台視窗顯示這些值。 最後,程式碼會在主控台視窗中顯示提示,並呼叫 Console.ReadKey(Boolean) 方法,以等候使用者輸入。

    NewLine 是表示分行符號的方式,不受平台或語言影響。 與 C# 中的 \n 相同。

    字串前的貨幣符號 ($) 可讓您將變數名稱等運算式以大括號的方式放到字串中。 運算式的值會插入字串中,以取代運算式。 此語法稱為差補字串

  3. 儲存您的變更。

    重要

    在 Visual Studio Code 中,您必須明確儲存變更。 不同於 Visual Studio,當您建置和執行應用程式時,系統不會自動儲存檔案變更。

  4. 再次執行程式:

    dotnet run
    
  5. 輸入名稱並按 Enter 鍵來回應提示。

    Terminal window with modified program output

  6. 按任意鍵以結束該程式。

其他資源

下一步

在本教學課程中,您已建立 .NET 控制台應用程式。 在下一個教學課程中,您會對應用程式進行偵錯。

本教學課程說明如何使用 Visual Studio Code 與 .NET CLI 建立及執行 .NET 主控台應用程式。 使用 .NET CLI 可以完成建立、編譯、執行專案等專案工作。 如有需要,您可以使用不同程式碼編輯器遵循本教學課程,並在終端機中執行命令。

必要條件

建立 應用程式

建立名為 "HelloWorld" 的 .NET 主控台應用程式專案。

  1. 啟動 Visual Studio Code。

  2. 在主要功能表中依序點選 [檔案] > [開啟資料夾] (在 macOS 上請依序點選 [檔案] > [開啟...])。

  3. 在 [開啟資料夾] 對話方塊中建立 [HelloWorld] 資料夾並加以選取。 接著按一下 [選取資料夾] (在 macOS 上請按一下 [開啟])。

    資料夾名稱會預設為專案名稱和命名空間名稱。 您稍後在教學課程中會新增程式碼,專案命名空間假設為 HelloWorld

  4. 在 [您是否信任此資料夾中檔案的作者?] 對話方塊中,選取 [是,我信任作者]。 您可以信任作者,因為此資料夾只有 .NET 產生的檔案,並由您新增或修改。

  5. 在主要功能表內選取 [檢視]>[終端],便能於 Visual Studio Code 中開啟 [終端]

    終端會與命令提示字元一起在「HelloWorld」資料夾中開啟。

  6. 終端中輸入下列命令:

    dotnet new console --framework net7.0
    

    這個專案範本會在「Program.cs」中呼叫 Console.WriteLine(String) 方法,藉此建立簡單的應用程式,在主控台視窗中顯示「Hello, World」。

    Console.WriteLine("Hello, World!");
    
  7. 使用下列程式碼取代 Program.cs 的內容:

    namespace HelloWorld
    {
        class Program
        {
            static void Main(string[] args)
            {
                Console.WriteLine("Hello, World!");
            }
        }
    }
    

    第一次編輯「.cs」檔案時,Visual Studio Code 會提示您新增遺漏的資產,以建置應用程式並加以偵錯。 選取 [是],Visual Studio Code 便會建立含有 launch.json 與 tasks.json 檔案的 [.vscode] 資料夾。

    注意

    如果您沒有收到提示,或者尚未選取 [是] 就不小心關閉提示,請按照下列步驟建立 launch.jsontasks.json 檔案:

    • 在功能表中選取 [執行] > [新增設定]。
    • 在[選取環境] 提示中選取 .NET 5+ and .NET Core

    此程式碼會定義 Program 類別,其中包含單一方法 Main,會將 String 陣列作為引數。 Main 是應用程式進入點,是執行階段在啟動應用程式時會自動呼叫的方法。 在應用程式啟動時所提供的所有命令列引數,都會在 args 陣列中提供。

    最新版的 C# 提供名為最上層陳述式的新功能,可讓您省略 Program 類別與 Main 方法。 現有的 C# 程式大部分都不使用最上層陳述式,故本教學課程不會使用這項新功能。 但 C# 10 具備此功能,所以您可以根據自己的樣式偏好,決定是否要在程式中使用最上層陳述式。

執行應用程式

終端執行下列命令:

dotnet run

程式會顯示「Hello, World!」,然後結束。

The dotnet run command

增強應用程式

增強應用程式後,便可提示使用者輸入其名稱,並與日期和時間一併顯示。

  1. 開啟 Program.cs

  2. 在 Program.cs 中以下列程式碼取代 Main 方法的內容 (即呼叫 Console.WriteLine 的那一行):

    Console.WriteLine("What is your name?");
    var name = Console.ReadLine();
    var currentDate = DateTime.Now;
    Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
    Console.Write($"{Environment.NewLine}Press any key to exit...");
    Console.ReadKey(true);
    

    此程式碼會在主控台視窗中顯示提示,然後等待使用者輸入字串並按下 Enter 鍵。 程式碼會將此字串儲存在名為 name 的變數中, 此程式碼也會擷取 DateTime.Now 屬性的值,其中包含目前的當地時間,並將它指派至名稱為 currentDate 的變數。 並在主控台視窗顯示這些值。 最後,程式碼會在主控台視窗中顯示提示,並呼叫 Console.ReadKey(Boolean) 方法,以等候使用者輸入。

    NewLine 是表示分行符號的方式,不受平台或語言影響。 其他表示方式還有 C# 中的 \n 和 Visual Basic 中的 vbCrLf

    字串前的貨幣符號 ($) 可讓您將變數名稱等運算式以大括號的方式放到字串中。 運算式的值會插入字串中,以取代運算式。 此語法稱為差補字串

  3. 儲存您的變更。

    重要

    在 Visual Studio Code 中,您必須明確儲存變更。 不同於 Visual Studio,當您建置和執行應用程式時,系統不會自動儲存檔案變更。

  4. 再次執行程式:

    dotnet run
    
  5. 輸入名稱並按 Enter 鍵來回應提示。

    Terminal window with modified program output

  6. 按任意鍵以結束該程式。

其他資源

下一步

在本教學課程中,您已建立 .NET 控制台應用程式。 在下一個教學課程中,您會對應用程式進行偵錯。

本教學課程說明如何使用 Visual Studio Code 與 .NET CLI 建立及執行 .NET 主控台應用程式。 使用 .NET CLI 可以完成建立、編譯、執行專案等專案工作。 如有需要,您可以使用不同程式碼編輯器遵循本教學課程,並在終端機中執行命令。

必要條件

建立 應用程式

建立名為 "HelloWorld" 的 .NET 主控台應用程式專案。

  1. 啟動 Visual Studio Code。

  2. 在主要功能表中依序點選 [檔案] > [開啟資料夾] (在 macOS 上請依序點選 [檔案] > [開啟...])。

  3. 在 [開啟資料夾] 對話方塊中建立 [HelloWorld] 資料夾並加以選取。 接著按一下 [選取資料夾] (在 macOS 上請按一下 [開啟])。

    資料夾名稱會預設為專案名稱和命名空間名稱。 您稍後在教學課程中會新增程式碼,專案命名空間假設為 HelloWorld

  4. 在 [您是否信任此資料夾中檔案的作者?] 對話方塊中,選取 [是,我信任作者]。 您可以信任作者,因為此資料夾只有 .NET 產生的檔案,並由您新增或修改。

  5. 在主要功能表內選取 [檢視]>[終端],便能於 Visual Studio Code 中開啟 [終端]

    終端會與命令提示字元一起在「HelloWorld」資料夾中開啟。

  6. 終端中輸入下列命令:

    dotnet new console --framework net6.0 --use-program-main
    

    這個專案範本會在「Program.cs」中呼叫 Console.WriteLine(String) 方法,藉此建立簡單的應用程式,在主控台視窗中顯示「Hello, World」。

    namespace HelloWorld;
    
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello, World!");
        }
    }
    

    第一次編輯「.cs」檔案時,Visual Studio Code 會提示您新增遺漏的資產,以建置應用程式並加以偵錯。 選取 [是],Visual Studio Code 便會建立含有 launch.json 與 tasks.json 檔案的 [.vscode] 資料夾。

    注意

    如果您沒有收到提示,或者尚未選取 [是] 就不小心關閉提示,請按照下列步驟建立 launch.jsontasks.json 檔案:

    • 在功能表中選取 [執行] > [新增設定]。
    • 在[選取環境] 提示中選取 .NET 5+ and .NET Core

    此程式碼會定義 Program 類別,其中包含單一方法 Main,會將 String 陣列作為引數。 Main 是應用程式進入點,是執行階段在啟動應用程式時會自動呼叫的方法。 在應用程式啟動時所提供的所有命令列引數,都會在 args 陣列中提供。

    最新版的 C# 提供名為最上層陳述式的新功能,可讓您省略 Program 類別與 Main 方法。 現有的 C# 程式大部分都不使用最上層陳述式,故本教學課程不會使用這項新功能。 但 C# 10 具備此功能,所以您可以根據自己的樣式偏好,決定是否要在程式中使用最上層陳述式。 在用於建立專案的 dotnet new 命令中,--use-program-main 選項會禁止使用最上層陳述式。

執行應用程式

終端執行下列命令:

dotnet run

程式會顯示「Hello, World!」,然後結束。

The dotnet run command

增強應用程式

增強應用程式後,便可提示使用者輸入其名稱,並與日期和時間一併顯示。

  1. 開啟 Program.cs

  2. 在 Program.cs 中以下列程式碼取代 Main 方法的內容 (即呼叫 Console.WriteLine 的那一行):

    Console.WriteLine("What is your name?");
    var name = Console.ReadLine();
    var currentDate = DateTime.Now;
    Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
    Console.Write($"{Environment.NewLine}Press any key to exit...");
    Console.ReadKey(true);
    

    此程式碼會在主控台視窗中顯示提示,然後等待使用者輸入字串並按下 Enter 鍵。 程式碼會將此字串儲存在名為 name 的變數中, 此程式碼也會擷取 DateTime.Now 屬性的值,其中包含目前的當地時間,並將它指派至名稱為 currentDate 的變數。 並在主控台視窗顯示這些值。 最後,程式碼會在主控台視窗中顯示提示,並呼叫 Console.ReadKey(Boolean) 方法,以等候使用者輸入。

    NewLine 是表示分行符號的方式,不受平台或語言影響。 其他表示方式還有 C# 中的 \n 和 Visual Basic 中的 vbCrLf

    字串前的貨幣符號 ($) 可讓您將變數名稱等運算式以大括號的方式放到字串中。 運算式的值會插入字串中,以取代運算式。 此語法稱為差補字串

  3. 儲存您的變更。

    重要

    在 Visual Studio Code 中,您必須明確儲存變更。 不同於 Visual Studio,當您建置和執行應用程式時,系統不會自動儲存檔案變更。

  4. 再次執行程式:

    dotnet run
    
  5. 輸入名稱並按 Enter 鍵來回應提示。

    Terminal window with modified program output

  6. 按任意鍵以結束該程式。

其他資源

下一步

在本教學課程中,您已建立 .NET 控制台應用程式。 在下一個教學課程中,您會對應用程式進行偵錯。