如何让继承Button的自定义RoundButton控件默认清空Text属性？

问题根源 #

从Button继承创建自定义控件时，Visual Studio设计器会自动把控件的Text属性初始化为控件名称（比如roundButton1），而且你在构造函数里设置Text = string.Empty的操作会被设计器生成的InitializeComponent()代码覆盖——因为设计器会在初始化阶段显式给Text赋值。

解决方案 #

你需要通过重写Text属性并配置设计器序列化规则，让设计器在默认状态下不生成Text的赋值代码，同时保证运行时和设计器里的默认值为空。

方法1：重写Text属性并指定默认值 #

这是最直接的方案，通过DefaultValue特性告诉设计器空字符串是默认值，无需生成冗余赋值代码：

using System.ComponentModel;
using System.Windows.Forms;

public class RoundButton : Button
{
    [DefaultValue("")]
    public override string Text
    {
        get => base.Text;
        set => base.Text = value;
    }

    public RoundButton()
    {
        // 确保非设计模式下默认值也为空
        if (!DesignMode)
        {
            Text = string.Empty;
        }
    }
}

方法2：控制设计器序列化行为 #

如果希望设计器完全不自动生成Text的初始赋值，可使用DesignerSerializationVisibility特性：

using System.ComponentModel;
using System.Windows.Forms;

public class RoundButton : Button
{
    [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
    public override string Text
    {
        get => base.Text;
        set => base.Text = value;
    }

    public RoundButton()
    {
        Text = string.Empty;
    }
}

生效步骤 #

1. 修改代码后重新生成整个项目
2. 若窗体上已有旧的RoundButton控件，先删除再重新拖拽添加（旧的设计器代码已保留了Text赋值，需清除）

内容的提问来源于stack exchange，提问作者Andy Rehn