解决WPF TextBox自定义样式导致Caliburn.Micro属性变更失效问题

核心原因 #

自定义TextBox样式破坏了Caliburn.Micro依赖的原生TextBox属性绑定与事件路由，导致TextChanged事件无法触发VM的NotifyOfPropertyChange(() => UserName)，进而让CanLogin始终返回false，登录按钮保持禁用。

排查与修复步骤 #

1. 检查自定义TextBox模板的Text属性绑定 #

Caliburn.Micro通过控件名称约定绑定VM属性，依赖TextBox的原生Text属性同步更新。如果自定义模板未正确绑定内部输入元素的Text到控件本身，VM将无法感知输入变化：

• 打开你的TextBoxTheme，找到模板中的核心输入元素（通常是PART_ContentHost或内部TextBox），确保使用TemplateBinding绑定到控件的Text属性：

  <!-- 正确的绑定示例 -->
  <ScrollViewer x:Name="PART_ContentHost"
                Text="{TemplateBinding Text}"
                Focusable="false" />
  

• 若你实现了水印提示（内部添加了提示TextBlock），需确保输入内容的元素仍优先绑定原生Text属性，而非独立的自定义属性。

2. 确保TextChanged事件正常触发 #

Caliburn.Micro依赖TextChanged事件自动触发VM的属性变更通知。如果自定义模板中存在以下情况，会导致事件失效：

• 内部元素处理TextChanged事件后标记为e.Handled = true，阻止事件冒泡到外层TextBox；
• 模板结构破坏了TextBox的原生事件路由。
• 修复方式：移除事件处理中的e.Handled = true，确保事件能传递到外层TextBox。

3. 验证Caliburn.Micro的名称约定绑定 #

检查LoginView中的TextBox控件名是否与VM的UserName属性完全一致（大小写敏感）：

<!-- 控件名必须与VM属性名匹配 -->
<TextBox x:Name="UserName" Style="{StaticResource YourCustomTextBoxStyle}" />

若自定义样式修改了控件内部的命名规则，需确保未覆盖外层TextBox的名称绑定逻辑。

4. 手动绑定TextChanged事件（兜底方案） #

若自动绑定仍失效，可手动在TextBox上附加事件强制触发VM属性更新：

在LoginView中：

<TextBox x:Name="UserName" 
         Style="{StaticResource YourCustomTextBoxStyle}"
         cal:Message.Attach="[Event TextChanged] = [Action UpdateUserName($source)]" />

在LoginViewModel中添加对应方法：

public void UpdateUserName(TextBox source)
{
    UserName = source.Text;
    NotifyOfPropertyChange(() => UserName);
    NotifyOfPropertyChange(() => CanLogin); // 直接触发CanLogin的验证
}

5. PasswordBox的额外注意点 #

虽然你的问题聚焦于TextBox，但PasswordBox本身无原生Text属性，自定义样式时需确保PasswordChanged事件正常触发，同样可通过手动绑定事件同步VM的Password属性：

<PasswordBox x:Name="Password"
             Style="{StaticResource YourCustomPasswordBoxStyle}"
             cal:Message.Attach="[Event PasswordChanged] = [Action UpdatePassword($source)]" />

public void UpdatePassword(PasswordBox source)
{
    Password = source.Password;
    NotifyOfPropertyChange(() => Password);
    NotifyOfPropertyChange(() => CanLogin);
}

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