用户控件概述（Windows 窗体 .NET）

用户控件是封装到公共容器中的 Windows 窗体控件的集合。 此类控件称为复合控件。 其包含的控件称为构成控件。 用户控件派生自 UserControl 类。

用户控件的设计方式与窗体类似，具有可视化设计器。 通过视觉设计器创建、排列和修改构成控件。 控件事件和逻辑的编写方式与设计窗体时完全相同。 用户控件与任何其他控件一样放置在窗体上。

用户控件可由在其中创建它们的项目使用，也可在引用用户控件库的其他项目中使用。

重要

面向 .NET 7 和 .NET 6 的桌面指南文档正在撰写中。

构成控件

构成控件可供用户控件使用，应用用户可以在运行时单独与其交互，但构成控件声明的属性和方法不会向使用者公开。 例如，如果将 TextBox 和 Button 控件放在用户控件上，则按钮的 Click 事件由用户控件在内部处理，而不是由用户控件所在的窗体处理。

将用户控件添加到项目

创建新项目后，使用 Visual Studio 模板创建用户控件。 以下步骤演示如何将用户控件添加到项目：

1. 在 Visual Studio 中，找到“项目资源管理器”窗格。 右键单击项目并选择“添加”>“用户控件（Windows 窗体）”。

   

2. 在“名称”框中，键入用户控件的名称。 Visual Studio 提供一个可以使用的默认和唯一名称。 接下来，按“添加”。

   

创建用户控件后，Visual Studio 将打开设计器：

有关工作用户控件的示例，请参阅如何创建用户控件。