WinForms TextBox输入参数时TextChanged事件触发过早，如何延迟处理？

嘿，这个问题我太熟了——TextChanged事件确实会在每敲一个字符就触发，导致输入到一半就被强制修正，体验特别糟。针对这个场景，现在有几个更优雅的新方案，比早年的方法顺手多了：

这是目前WinForms里最常用的方式，核心思路是：用户每次输入时重置计时器，只有当用户停止输入一段时间（比如500ms，可按需调整）后，才执行校验逻辑。

实现步骤： #

1. 先在窗体类里声明一个Timer字段：

private Timer _inputDebounceTimer;

2. 在窗体构造函数里初始化计时器：

public YourGameSettingsForm()
{
    InitializeComponent();
    _inputDebounceTimer = new Timer();
    _inputDebounceTimer.Interval = 500; // 等待用户停止输入500ms再校验
    _inputDebounceTimer.Tick += DebounceTimer_Tick;
}

3. 修改原有的TextChanged事件，只负责重置计时器：

private void TXBheight_TextChanged(object sender, EventArgs e)
{
    _inputDebounceTimer.Stop();
    _inputDebounceTimer.Start();
}

4. 实现计时器的Tick事件，在这里完成真正的校验：

private void DebounceTimer_Tick(object sender, EventArgs e)
{
    _inputDebounceTimer.Stop();
    
    // 用TryParse代替Parse，避免输入非数字时抛出异常
    if (int.TryParse(TXBheight.Text, out int inputValue))
    {
        if (inputValue < 8)
        {
            TXBheight.Text = "8";
        }
        else if (inputValue > 32)
        {
            TXBheight.Text = "32";
        }
        // 把光标定位到文本末尾，避免修正后光标跳走影响体验
        TXBheight.SelectionStart = TXBheight.Text.Length;
    }
    else
    {
        // 输入无效时默认设为最小值8
        TXBheight.Text = "8";
    }
}

如果你的项目基于.NET Framework 4.5+或者.NET Core/.NET 5+，可以用异步延迟的方式实现，不需要依赖Timer控件，代码更紧凑：

实现步骤： #

1. 在窗体类里声明一个CancellationTokenSource字段，用来取消之前的延迟任务：

private CancellationTokenSource _debounceCts;

2. 将TextChanged事件改为异步方法：

private async void TXBheight_TextChanged(object sender, EventArgs e)
{
    // 取消之前的延迟任务（如果用户又输入了新字符）
    _debounceCts?.Cancel();
    _debounceCts = new CancellationTokenSource();

    try
    {
        // 等待500ms，期间用户输入新字符就会取消这个任务
        await Task.Delay(500, _debounceCts.Token);
        
        // 执行校验逻辑
        if (int.TryParse(TXBheight.Text, out int inputValue))
        {
            TXBheight.Text = inputValue switch
            {
                <8 => "8",
                >32 => "32",
                _ => TXBheight.Text
            };
            TXBheight.SelectionStart = TXBheight.Text.Length;
        }
        else
        {
            TXBheight.Text = "8";
        }
    }
    catch (TaskCanceledException)
    {
        // 任务被取消，说明用户正在输入，直接忽略即可
    }
}

为了减少无效输入的情况，可以在TextBox的KeyPress事件里限制用户只能输入数字和退格键：

private void TXBheight_KeyPress(object sender, KeyPressEventArgs e)
{
    // 只允许数字和退格键
    if (!char.IsDigit(e.KeyChar) && e.KeyChar != (char)Keys.Back)
    {
        e.Handled = true;
    }
}

这两种方案都是当前主流的实现方式，Timer方案兼容性更好（适合老版本.NET），async/await方案代码更简洁现代。另外一定要用int.TryParse代替int.Parse，避免程序因无效输入崩溃，同时调整光标位置能大幅提升用户体验。

内容的提问来源于stack exchange，提问作者Amine Fellous