WinUI3中TextBox的BeforeTextChanging事件正确用法及报错解决

错误原因 #

你遇到CS0123编译错误的核心原因是事件处理方法的参数类型与事件委托签名不匹配：
BeforeTextChanging事件要求第二个事件参数类型为TextBoxBeforeTextChangingEventArgs，你错误使用了TextChangedEventArgs，导致编译器无法找到匹配的处理方法重载。

事件签名public event TypedEventHandler<TextBox,TextBoxBeforeTextChangingEventArgs> BeforeTextChanging;的含义：

• 这是泛型类型的事件委托，第一个泛型参数指定事件触发源sender的类型为TextBox，第二个泛型参数指定事件携带数据的类型为TextBoxBeforeTextChangingEventArgs
• 处理该事件时，你既可以把sender声明为object类型再手动转换，也可以直接声明为TextBox类型省去转换步骤

正确代码实现 #

1. XAML端代码（原有写法正确，无需修改） #

<TextBox x:Name="LicencePlateInputBox" BeforeTextChanging="HandleLicencePlateNumber"/>

2. 后台cs事件处理方法 #

修正参数类型后的简洁写法：

// 注意第二个参数类型必须是TextBoxBeforeTextChangingEventArgs
private void HandleLicencePlateNumber(TextBox sender, TextBoxBeforeTextChangingEventArgs args)
{
    // sender就是触发事件的LicencePlateInputBox实例，可直接使用，无需类型转换
}

如果你习惯用object类型的sender，以下写法也可以正常编译运行：

private void HandleLicencePlateNumber(object sender, TextBoxBeforeTextChangingEventArgs args)
{
    TextBox textBox = sender as TextBox;
    // 后续业务逻辑
}

常用功能示例 #

BeforeTextChanging事件在文本实际写入输入框之前触发，最常见的用途是做输入合法性校验，不符合规则的输入可以直接拦截，避免非法文本写入控件。以车牌输入校验为例（仅允许大写字母、数字，最长8位）：

private void HandleLicencePlateNumber(TextBox sender, TextBoxBeforeTextChangingEventArgs args)
{
    // 允许清空操作
    if (string.IsNullOrEmpty(args.NewText))
        return;

    // 拦截超长输入
    if (args.NewText.Length > 8)
    {
        args.Cancel = true;
        return;
    }

    // 拦截非法字符
    foreach (char c in args.NewText)
    {
        bool isValid = char.IsDigit(c) || (char.IsLetter(c) && char.IsUpper(c));
        if (!isValid)
        {
            args.Cancel = true;
            return;
        }
    }
}

事件参数核心常用成员：

• args.NewText：获取本次修改生效后，输入框将显示的完整新文本
• args.Cancel：设置为true即可取消本次文本修改，拦截非法输入

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