使用者控制元件概觀 （Windows Forms .NET）

使用者控制件是封裝在通用容器中的 Windows Forms 控制件集合。 這種控件稱為 複合控件。 包含的控制項稱為「組成控制項」。 使用者控件衍生自 類別 UserControl 。

使用者控件的設計方式與表單類似，具有可視化設計工具。 您可以透過視覺化設計工具建立、排列和修改組成控制項。 控件事件和邏輯的撰寫方式與設計表單時完全相同。 使用者控件會與任何其他控件一樣放在窗體上。

使用者控制項可供建立所在的專案使用，或在其他具有使用者控件連結庫參考的專案中使用。

重要

.NET 7 和 .NET 6 的桌面指南檔正在建置中。

組成控制件

組成控件可供使用者控制項使用，而且應用程式使用者可以在運行時間與它們個別互動，但組成控件所宣告的屬性和方法不會公開給取用者。 例如，如果您將和 Button 控件放在TextBox使用者控件上，按鈕Click的事件會由使用者控件在內部處理，但不會由使用者控件放置所在的表單處理。

將使用者控件新增至專案

建立新項目之後，請使用Visual Studio樣本來建立使用者控件。 下列步驟示範如何將使用者控制項新增至您的專案：

1. 在 Visual Studio 中，尋找 [ 項目總管] 窗格。 以滑鼠右鍵按兩下項目，然後選擇 [新增>使用者控件] [Windows Forms]。

   

2. 在 [ 名稱] 方塊中，輸入使用者控件的名稱。 Visual Studio 提供您可以使用的預設和唯一名稱。 接下來，按 [新增]。

   

建立使用者控件之後，Visual Studio 會開啟設計工具：

如需運作中使用者控件的範例，請參閱 如何建立使用者控件。