在C#桌面应用开发中，当系统自带的控件无法适配业务场景的特殊需求时，自定义控件就成为实现个性化界面和功能的重要方式。本文以WinForms平台为例，讲解自定义控件的完整开发流程。
C#自定义控件的基础分类
C#中自定义控件主要分为三类，开发者可以根据需求选择合适的类型：
- 用户控件（UserControl）：通过组合现有控件实现新功能，适合快速开发复合功能的控件，开发难度较低。
- 自定义控件（继承Control类）：直接继承基础Control类，完全自定义绘制和交互逻辑，灵活性最高，开发难度较大。
- 扩展现有控件：继承某个现有控件（如Button、TextBox），在其基础上添加新属性或重写方法，适合小幅扩展现有控件功能。
实战：开发带计数功能的自定义按钮控件
下面我们通过继承Button类扩展一个带点击计数功能的按钮，实现每次点击按钮时显示当前点击次数。
第一步：创建自定义控件项目
打开Visual Studio，新建一个Windows 窗体控件库项目，命名为CustomButtonLib，默认会生成一个UserControl1.cs文件，我们删除该文件，新建一个类文件CountButton.cs。
第二步：编写控件核心代码
CountButton类继承Button类，添加点击计数属性和重写点击事件处理逻辑，代码如下：
using System;
using System.Windows.Forms;
namespace CustomButtonLib
{
// 继承Button类扩展自定义按钮
public class CountButton : Button
{
// 私有字段存储点击次数
private int _clickCount = 0;
// 公开点击次数属性，供外部读取
public int ClickCount
{
get { return _clickCount; }
private set { _clickCount = value; }
}
// 重写OnClick方法，处理点击事件
protected override void OnClick(EventArgs e)
{
// 先执行基类的点击事件逻辑
base.OnClick(e);
// 点击次数加1
_clickCount++;
// 更新按钮显示的文本
this.Text = $"点击次数：{_clickCount}";
}
// 自定义事件：点击次数达到阈值时触发
public event Action<int> CountReached;
// 可以添加阈值属性，当点击次数达到阈值时触发事件
private int _threshold = 10;
public int Threshold
{
get { return _threshold; }
set { _threshold = value; }
}
// 修改OnClick方法，添加阈值判断逻辑
protected override void OnClick(EventArgs e)
{
base.OnClick(e);
_clickCount++;
this.Text = $"点击次数：{_clickCount}";
// 如果设置了阈值且达到阈值，触发事件
if (CountReached != null && _clickCount >= _threshold)
{
CountReached.Invoke(_clickCount);
}
}
}
}
第三步：生成并引用控件
编译CustomButtonLib项目，生成CustomButtonLib.dll文件。新建一个WinForms应用项目，在工具箱中右键选择“选择项”，浏览并添加生成的dll文件，CountButton控件就会出现在工具箱中，可以直接拖到窗体使用。
第四步：测试自定义控件
在窗体中拖入CountButton控件，设置Threshold属性为5，绑定CountReached事件，代码如下：
using System;
using System.Windows.Forms;
namespace CustomButtonTest
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
// 绑定计数达到阈值的事件
countButton1.CountReached += CountButton1_CountReached;
}
private void CountButton1_CountReached(int count)
{
MessageBox.Show($"按钮点击次数已达到{count}次");
}
}
}
自定义控件的常用优化技巧
| 优化方向 | 具体方法 |
|---|---|
| 属性设计 | 为自定义属性添加[Category("自定义属性")]特性，让属性在属性面板中分类显示，方便使用者配置 |
| 绘制优化 | 如果需要自定义绘制，重写OnPaint方法，使用双缓冲减少闪烁，设置this.DoubleBuffered = true; |
| 事件规范 | 自定义事件遵循.NET事件规范，使用EventHandler委托，传递自定义的事件参数类 |
注意事项
自定义控件开发时，尽量避免在控件内部直接操作外部窗体的控件，保持控件的独立性，降低耦合度。如果需要在控件中通知外部状态变化，优先使用事件机制而不是直接调用外部方法。
另外，自定义控件的命名要清晰，避免和现有控件名称冲突，同时做好注释，方便后续维护和他人使用。
C#自定义控件WinFormsUserControl控件开发修改时间：2026-06-15 00:51:24