带CoerceValueCallback的DependencyProperty异常问题排查

原因 #

当控件的NumberProperty被设置为6时，CoerceValueCallback将其转为0，但此时控件的当前有效值已经是0，WPF认为值没有发生实际变化，因此不会触发PropertyChangedCallback。如果你的ViewModel是通过该回调更新，或者使用了OneWayToSource绑定（在Coerce前就把6同步到了ViewModel），就会导致ViewModel保留6，而控件显示0的不一致情况。

解决方案 #

方案1：改用双向绑定并确保源同步到Coerce后的值 #

1. 确保NumberProperty注册时设置BindsTwoWayByDefault=true（明确设置更稳妥）。
2. 使用TwoWay绑定并设置UpdateSourceTrigger=PropertyChanged，依赖WPF绑定机制自动同步Coerce后的值：

   <local:OwnControl Number="{Binding ViewModelNumber, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />
   

   WPF会先执行Coerce逻辑，再将最终有效值同步到源，ViewModel会直接得到0，无需手动在PropertyChangedCallback中更新。

方案2：强制触发属性变更通知（谨慎使用） #

如果必须保留手动更新ViewModel的逻辑，可在CoerceValueCallback中，当值被强制修改时手动触发属性变更：

private static object CoerceNumberValue(DependencyObject d, object baseValue)
{
    int value = (int)baseValue;
    int coercedValue = value > 5 ? 0 : value;
    if (coercedValue != value)
    {
        d.InvalidateProperty(NumberProperty);
    }
    return coercedValue;
}

注意：这种方式可能导致PropertyChangedCallback被多次调用，需避免循环逻辑。

原因 #

这个0的来源大概率是ViewModel的初始值同步到了控件：

• 你使用了双向绑定，ViewModel的Number属性初始值为0，启动时WPF会将ViewModel的0同步到控件的NumberProperty，覆盖了默认值2。
• 此时PropertyChangedCallback触发，oldValue是依赖属性的默认值2，newValue是从ViewModel同步过来的0，而CoerceValueCallback因为0不大于5，直接返回0，最终控件值为0。

额外排查方向：

• 控件XAML中是否显式设置了Number="0"；
• 控件构造函数/Loaded事件中是否手动设置了Number=0；
• CoerceValueCallback逻辑是否有误（比如误写为value >=5）。

解决方案 #

1. 若希望控件启动时显示默认值2，将ViewModel的Number属性初始值设为2，或把绑定Mode改为OneWay（需手动处理控件到ViewModel的更新）。
2. 若不需要默认值2，直接将依赖属性的默认值设为0即可。

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