教學課程：使用 .NET 建立 Windows Forms 應用程式

發行項
09/26/2024

在本簡短的教學課程中，您將了解如何使用 Visual Studio 建立新的 Windows Forms 應用程式。產生初始應用程式之後，您將了解如何新增控制項，以及如何處理事件。在本教學課程結束時，您將有一個簡單的應用程式，可將名稱新增至清單方塊。

在本教學課程中，您會了解如何：

建立新的 Windows Forms 應用程式
將控制項新增至表單
處理控制項事件以提供應用程式功能
執行應用程式

必要條件

Visual Studio 2022 17.0 版或更新版本
- 選取 [.NET 桌面開發工作負載]
- 選取 [.NET 6 個別元件]

Visual Studio 2022 17.4 版或更新版本
- 選取 [.NET 桌面開發工作負載]
- 選取 [.NET 7 個別元件]

提示

使用 Visual Studio 2022 17.4 版或更新版本，並同時安裝 .NET 7 和 .NET 6 個別元件。 Visual Studio 2022 17.4 版已新增 .NET 7 的支援。

建立 Windows Forms 應用程式

建立新應用程式的第一個步驟是開啟 Visual Studio，並從範本產生應用程式。

開啟 Visual Studio。
選取 [建立新專案]。
在 [搜尋範本] 方塊中，輸入 winforms，並等候搜尋結果出現。
在 [程式碼語言] 下拉式清單中，選擇 [C#] 或 [Visual Basic]。
在範本清單中，選取 [Windows Forms 應用程式]，然後按 [下一步]。

重要

請勿選取 [Windows Forms 應用程式 (.NET Framework)] 範本。

下圖顯示 C# 和 Visual Basic .NET 專案範本。如果您已套用程式碼語言篩選，則會看到對應的範本。
在 [設定新專案] 視窗中，將 [專案名稱] 設定為 [名稱]，然後按 [下一步]。

您也可以藉由調整 [位置] 路徑，將專案儲存至不同的資料夾。
最後，在 [其他資訊] 視窗中，選取 [架構] 設定的 [.NET 6.0 (長期支援)]，然後按一下 [建立]。

開啟 Visual Studio。
選取 [建立新專案]。
在 [搜尋範本] 方塊中，輸入 winforms，並等候搜尋結果出現。
在 [程式碼語言] 下拉式清單中，選擇 [C#] 或 [Visual Basic]。
在範本清單中，選取 [Windows Forms 應用程式]，然後按 [下一步]。

重要

請勿選取 [Windows Forms 應用程式 (.NET Framework)] 範本。

下圖顯示 C# 和 Visual Basic .NET 專案範本。如果您已套用程式碼語言篩選，則會看到對應的範本。
在 [設定新專案] 視窗中，將 [專案名稱] 設定為 [名稱]，然後按 [下一步]。

您也可以藉由調整 [位置] 路徑，將專案儲存至不同的資料夾。
最後，在 [其他資訊] 視窗中，選取 [Framework] 設定的 [.NET 7.0 (標準期間支援)]，然後按一下 [建立]。

產生應用程式之後，Visual Studio 應該會開啟預設表單 Form1 的設計工具窗格。如果看不到表單設計師，請按兩下 [方案總管] 窗格中的表單，以開啟設計師視窗。

Visual Studio 的重要部分

Visual Studio 中的 Windows Forms 支援有四個重要元件，您會在建立應用程式時與其互動：

建立適用於 .NET 的 Windows Forms 專案時，您應該知道 Visual Studio 2022 的重要元件。

方案總管

您的所有專案檔、程式碼、表單、資源都會出現在此窗格中。
屬性

此窗格會顯示您可以根據選取項目設定的屬性設定。例如，如果您從 [方案總管] 選取項目，則會看到與檔案相關的屬性設定。如果您在設計師中選取物件，則會看到控制項或表單的設定。
表單設計師

這是表單的設計工具。它是互動式的，而您可以從 [工具箱] 拖放物件。藉由在設計工具中選取和移動項目，您能夠以視覺化方式撰寫應用程式的使用者介面 (UI)。
工具箱

工具箱包含您可以新增至表單的所有控制項。若要將控制項新增至目前表單，請按兩下控制項或拖放控制項。

提示

如果看不到工具箱，您可以透過 [檢視]>[工具箱] 功能表項加以顯示。

控制項加入至表單

開啟 Form1 表單設計師時，使用 [工具箱] 窗格將下列控制項新增至表單：

標籤
Button
Listbox
文字方塊

您可以根據下列設定來安置控制項並調整大小。以視覺化方式移動它們以符合下列螢幕擷取畫面，或按一下每個控制項，然後在 [屬性] 窗格中進行設定。您也可以按一下表單標題區來選取表單：

Object	設定	值
表單	Text	`Names`
	大小	`268, 180`
標籤	Location	`12, 9`
	Text	`Names`
Listbox	名稱	`lstNames`
	Location	`12, 27`
	大小	`120, 94`
文字方塊	名稱	`txtName`
	Location	`138, 26`
	大小	`100, 23`
按鈕	名稱	`btnAdd`
	Location	`138, 55`
	大小	`100, 23`
	Text	`Add Name`

設計工具中應該有類似下列的表單：

Visual Studio 2022 設計工具，其中表單已針對適用於 .NET 的 Windows Forms 開啟。

處理事件

現在表單已配置其所有其控制項，您需要處理控制項的事件，以回應使用者輸入。當表單設計師仍然開啟時，請執行下列步驟：

選取表單上的按鈕控制項。
在 [屬性] 窗格中，按一下事件圖示以列出按鈕的事件。
尋找 Click 事件，然後按兩下它以產生事件處理常式。

此動作會將下列程式碼新增至表單：
```
private void btnAdd_Click(object sender, EventArgs e)
{

}
```
```
Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click

End Sub
```
我們在此處理常式中放置的程式碼會將 txtName 文字方塊控制項所指定的名稱新增至 lstNames listbox 控制項。不過，我們想要有兩個條件來新增名稱：提供的名稱不得為空白，且名稱不得已存在。

下列程式碼示範如何將名稱加入 lstNames 控制項中：

private void btnAdd_Click(object sender, EventArgs e)
{
    if (!string.IsNullOrWhiteSpace(txtName.Text) && !lstNames.Items.Contains(txtName.Text))
        lstNames.Items.Add(txtName.Text);
}

Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
    If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then
        lstNames.Items.Add(txtName.Text)
    End If
End Sub

執行應用程式

既然事件已經編碼，您可以按 F5 鍵或從功能表中選取 [偵錯]>[開始偵錯] 來執行應用程式。表單隨即顯示，而您可以在文字方塊中輸入名稱，然後按一下按鈕加以新增。

在 Visual Studio 2022 中執行適用於 .NET 的 Windows Forms 應用程式。

下一步

深入了解 Windows Forms

共用方式為