WPF动态切换MaskedTextBox掩码触发参数异常问题

场景与实现 #

开发中使用MaskedTextBox控件强制用户按指定格式输入电话号码，因电话号码存在多套格式规范，需要新增「通用适配」类型的掩码选项，实现逻辑如下：

• 界面添加承载格式选项的ComboBox控件，XAML代码如下：

  <ComboBox x:Name="LContactNumberFormat" SelectionChanged="LContactNumberFormat_SelectionChanged">
      <ComboBoxItem Content="+27" FontFamily="Arial Nova"/>
      <ComboBoxItem Content="+44" FontFamily="Arial Nova"/>
      <ComboBoxItem Content="000" FontFamily="Arial Nova"/>
  </ComboBox>
  

• 下拉选项中000对应通用适配选项，用户选择选项后通过监听SelectionChanged事件动态更新MaskedTextBox的Mask属性，后台C#代码如下：

  private void LContactNumberFormat_SelectionChanged(object sender, SelectionChangedEventArgs e)
  {
      string temp;
      if (LContactNumberFormat.SelectedItem != null)
      {
          ComboBoxItem cbi = (ComboBoxItem)LContactNumberFormat.SelectedItem;
          temp = cbi.Content.ToString(); // 存储下拉选项值用于拼接掩码
          LUserTelephoneNumber.Mask = $"{temp} 000000000"; // 根据选项更新文本框掩码
      }
  }
  

异常现象 #

功能初始运行正常，但存在固定复现的报错：

System.ArgumentException: 'The mask cannot be applied to the current text. (Parameter 'Mask')'

异常触发规律：

• 选择000通用选项并在文本框输入号码内容后，切换到+27或+44格式时必然抛出上述异常
• +27和+44两个选项之间互相切换无异常
• 文本框内容为空时，切换所有格式选项均不会触发报错

原因分析 #

MaskedTextBox更新Mask属性时，会自动校验当前已存在的文本是否符合新掩码的格式规则：

• 选择000选项时生成的掩码为000 000000000，所有非空格位置均要求输入数字，用户输入完成后文本内容全为数字+分隔空格
• 切换到+27/+44选项时，新掩码前3位为固定字面量（如+27对应第一位是+、第二位是2、第三位是7），控件校验时发现现有文本第一位是数字，和新掩码要求的+字面量完全不匹配，直接抛出参数异常
• +27和+44两个掩码的前缀都是+加数字的固定字面量结构，已输入内容的前缀部分和新掩码的字面量要求匹配，因此不会触发校验失败

修复方案 #

根据业务需求二选一即可：

1. 不需要保留用户已输入内容的场景：切换掩码前主动清空文本框现有内容，从根源避免格式不匹配问题，修改后的事件代码如下：

   private void LContactNumberFormat_SelectionChanged(object sender, SelectionChangedEventArgs e)
   {
       if (LContactNumberFormat.SelectedItem != null)
       {
           ComboBoxItem cbi = (ComboBoxItem)LContactNumberFormat.SelectedItem;
           string temp = cbi.Content.ToString();
           // 切换掩码前清空现有内容，规避格式校验失败
           LUserTelephoneNumber.Clear();
           LUserTelephoneNumber.Mask = $"{temp} 000000000";
       }
   }
   

2. 需要保留用户输入的有效号码内容的场景：切换掩码前提取现有文本中的纯数字内容，新掩码加载完成后，将提取到的数字按顺序回填到掩码对应的数字输入位即可，避免固定字面量位置的内容冲突。

补充优化建议：当前通用选项使用000作为前缀不符合掩码规则语义——Mask语法中0代表必填数字位，并非通配符，如果要实现真正的通用前缀适配，建议使用9（可选数字位）作为通用前缀的占位符，适配更多非固定前缀的号码格式。

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