C# Windows Form项目中如何将TextBox默认提示逻辑封装为独立类调用

1. 编写DefaultText独立类 #

在项目中新建DefaultText.cs文件，写入以下代码：

using System;
using System.Drawing;
using System.Windows.Forms;

public class DefaultText
{
    private readonly TextBox _targetTextBox;
    private readonly string _defaultTip;
    private readonly Color _tipColor = Color.Gray;
    private readonly Color _inputColor = Color.Black;

    // 构造函数传入目标文本框和对应的默认提示内容
    public DefaultText(TextBox target, string defaultTip)
    {
        _targetTextBox = target;
        _defaultTip = defaultTip;
        // 绑定焦点事件
        _targetTextBox.Enter += OnTextBoxEnter;
        _targetTextBox.Leave += OnTextBoxLeave;
        // 初始化显示提示文本
        RefreshDefaultText();
    }

    private void RefreshDefaultText()
    {
        if (string.IsNullOrWhiteSpace(_targetTextBox.Text))
        {
            _targetTextBox.Text = _defaultTip;
            _targetTextBox.ForeColor = _tipColor;
        }
    }

    private void OnTextBoxEnter(object sender, EventArgs e)
    {
        // 当前显示的是提示文本时，清空内容切换为输入状态
        if (_targetTextBox.ForeColor == _tipColor && _targetTextBox.Text == _defaultTip)
        {
            _targetTextBox.Text = string.Empty;
            _targetTextBox.ForeColor = _inputColor;
        }
    }

    private void OnTextBoxLeave(object sender, EventArgs e)
    {
        // 失焦时内容为空则恢复提示文本
        RefreshDefaultText();
    }
}

2. 窗体中调用 #

直接在Form_Load事件中为需要占位提示的文本框初始化DefaultText实例即可，无需单独绑定每个文本框的事件：

private void Form1_Load(object sender, EventArgs e)
{
    // 示例：为三个文本框分别设置不同的提示文本
    new DefaultText(textBox1, "请输入用户名");
    new DefaultText(textBox2, "请输入手机号码");
    new DefaultText(textBox3, "请输入详细地址");
}

注：如果使用C# 7.0及以上版本，也可以用_ = new DefaultText(...)的 discard 语法明确表示不需要接收实例返回值，低版本C#直接编写new DefaultText(...)即可正常运行。

方案优势 #

• 所有占位文本的处理逻辑完全封装在独立类中，窗体代码无冗余重复逻辑
• 每个DefaultText实例与对应TextBox实例一一绑定，完全规避静态类处理实例逻辑的问题
• 后续新增需要占位提示的文本框，仅需在Form_Load中新增一行初始化代码即可，无需修改其他逻辑

内容的提问来源于stack exchange，提问作者Amit Gabay