UWP XAML开发中如何实现仅允许输入数字的PasswordBox控件

核心需要同时拦截键盘非数字输入、过滤粘贴/软键盘输入的非数字字符，避免单一拦截方式失效，适配桌面端键鼠操作场景。

具体实现步骤 #

• 首先在XAML中定义PasswordBox控件，绑定对应的事件：

<PasswordBox x:Name="NumericPwdBox"
             KeyDown="NumericPwdBox_KeyDown"
             PasswordChanged="NumericPwdBox_PasswordChanged"
             PlaceholderText="请输入数字密码"
             MaxLength="6"/> <!-- 可根据需要设置最大密码长度，比如常见6位支付密码 -->

• 后台代码编写KeyDown事件逻辑，拦截非数字按键，同时保留必要的控制按键（退格、方向键、删除等）：

using Windows.System;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Input;
using System.Text;

// ... 页面其他初始化代码

private void NumericPwdBox_KeyDown(object sender, KeyRoutedEventArgs e)
{
    // 放行常用控制按键，不影响基础编辑操作
    if (e.Key == VirtualKey.Back 
        || e.Key == VirtualKey.Delete 
        || e.Key == VirtualKey.Left 
        || e.Key == VirtualKey.Right
        || e.Key == VirtualKey.Tab)
    {
        return;
    }

    // 仅放行主键盘、小键盘区的0-9数字按键，其余按键直接拦截
    bool isNumericKey = (e.Key >= VirtualKey.Number0 && e.Key <= VirtualKey.Number9) 
                        || (e.Key >= VirtualKey.NumberPad0 && e.Key <= VirtualKey.NumberPad9);
    e.Handled = !isNumericKey;
}

• 补充PasswordChanged事件过滤逻辑，解决KeyDown无法拦截的粘贴、软键盘候选词输入问题，同时保留光标位置避免输入体验异常：

private void NumericPwdBox_PasswordChanged(object sender, RoutedEventArgs e)
{
    if (sender is not PasswordBox pwdBox) return;

    StringBuilder validContent = new StringBuilder();
    foreach (char c in pwdBox.Password)
    {
        if (char.IsDigit(c))
        {
            validContent.Append(c);
        }
    }

    string filteredPwd = validContent.ToString();
    if (pwdBox.Password != filteredPwd)
    {
        // 记录光标相对位置，过滤后还原光标，避免光标自动跳转到末尾
        int cursorOffset = pwdBox.Password.Length - pwdBox.SelectionStart;
        pwdBox.Password = filteredPwd;
        pwdBox.SelectionStart = Math.Max(0, filteredPwd.Length - cursorOffset);
    }
}

复用优化 #

如果项目中多处需要用到数字密码框，可以将上述逻辑封装为继承自PasswordBox的自定义用户控件，内置事件处理逻辑，使用时直接在XAML中引用自定义控件即可，无需重复编写事件代码。

实现效果参考：

注意：不要仅依赖KeyDown事件做输入限制，UWP中用户可通过右键粘贴、触控键盘候选词等方式绕过KeyDown拦截，必须配合内容变更后的二次过滤，才能保证输入内容仅包含数字。

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