C# WinForm实现TextBox仅输入数字：KeyPress与TextChanged双重校验

橘子海

发布时间：2026-10-14| 2人浏览过

原创

在C# WinForm应用程序中，经常需要限制用户只能在文本框（TextBox）中输入特定类型的字符，如纯数字。单纯依赖按键事件可能无法完全屏蔽通过右键菜单或快捷键粘贴的非数字内容。本文介绍结合 KeyPress 和 TextChanged 事件的完整方案，实现严谨的输入控制。

目标与准备

本方案旨在创建一个名为 textbox1 的控件，使其具备以下特性：

拦截键盘输入，仅允许数字键（0-9）及必要的编辑键（退格、全选、复制、粘贴）。
自动清理通过粘贴操作进入的非数字字符，保持文本框内始终为有效数字。

所需命名空间：System.Text, System.Text.RegularExpressions。

第1步：拦截键盘输入

目的：从源头减少非法字符的进入，提升响应速度。

操作入口：在窗体设计器双击TextBox，或手动订阅 KeyPress 事件。

核心逻辑：检查 e.KeyChar 是否为数字，或是允许的辅助功能键。

/// <summary>
/// 控制键盘输入只能是自然数
/// </summary>
private void textbox1_KeyPress(object sender, KeyPressEventArgs e)
{
    // 判断条件：
    // Char.IsDigit: 包含所有Unicode数字字符
    // (char)8: 退格键 (Backspace)
    // (char)1: 全选 (Ctrl+A)
    // (char)3: 复制 (Ctrl+C)
    // (char)22: 粘贴 (Ctrl+V)
    if (!Char.IsDigit(e.KeyChar) && e.KeyChar != 8 &&
        e.KeyChar != 1 && e.KeyChar != 3 && e.KeyChar != 22)
    {
        // 标记事件已处理，阻止默认输入行为
        e.Handled = true;
    }
}

第2步：清理粘贴内容

目的：应对用户通过右键“粘贴”或非标准方式注入包含字母、符号的字符串，确保最终存储数据纯粹。

操作入口：订阅TextBox的 TextChanged 事件。

重要参数：使用正则表达式 ^[0-9]*$ 匹配纯数字模式。

/// <summary>
/// 粘贴时过滤不是数字的字符
/// </summary>
private void textbox1_TextChanged(object sender, EventArgs e)
{
    var reg = new Regex("^[0-9]*$");
    var str = textbox1.Text.Trim();
    var sb = new StringBuilder();

    if (!reg.IsMatch(str))
    {
        // 遍历当前文本，保留所有数字字符
        for (int i = 0; i < str.Length; i++)
        {
            if (reg.IsMatch(str[i].ToString()))
            {
                sb.Append(str[i].ToString());
            }
        }
        
        // 将过滤后的结果重新赋值给Text属性
        textbox1.Text = sb.ToString();
        
        // 修正光标位置到末尾，避免光标跳到前面影响视觉体验
        textbox1.SelectionStart = textbox1.Text.Length;
    }
}

完成判断与排错

验证状态：运行程序后，尝试输入字母、符号或粘贴混合文本，观察TextBox是否自动清除非法部分且光标留在末尾。
常见陷阱：若在 TextChanged 中直接修改文本但未设置 SelectionStart，用户的输入焦点可能会突然跳转至文本起始位置，导致严重的交互体验问题。务必保留 textbox1.SelectionStart = textbox1.Text.Length; 这行代码。
空值处理：上述代码中使用了 .Trim()，如果初始为空串，正则匹配正常，不会触发循环，逻辑安全。