UWP/WinUI3中PropertyChangedCallback先于ViewModel绑定更新的问题

问题现象 #

我正在开发支持WPF、WinUI3和UWP的自定义ContentControl控件库，通过带PropertyChangedCallback的DependencyProperty实现IsChecked这类属性。WPF下双向绑定运行正常，但UWP和WinUI3出现异常：

• WPF执行顺序：1. 用户操作控件 → 2. ViewModel的IsChecked setter调用 → 3. PropertyChangedCallback触发 → 4. 命令执行（使用IsChecked新值）
• UWP/WinUI3执行顺序：1. 用户操作控件 → 2. PropertyChangedCallback触发 → 3. 命令执行（使用IsChecked旧值） → 4. ViewModel的IsChecked setter调用

这种顺序差异导致回调中调用的ViewModel命令/事件执行时，IsChecked仍为旧值，引发错误行为。

核心原因 #

WPF与WinUI3/UWP在双向绑定的更新调度逻辑上存在本质差异：

• WPF中，控件属性更新触发双向绑定时，会优先将新值同步到ViewModel的绑定属性，再触发DependencyProperty的PropertyChangedCallback
• WinUI3/UWP则是先执行PropertyChangedCallback，再完成ViewModel属性的更新同步

解决方案 #

针对WinUI3/UWP的顺序问题，可通过以下几种方式规避：

1. 延迟命令执行到ViewModel更新完成 #

利用UI线程调度器，将回调中的命令执行逻辑延迟到下一个调度周期，确保ViewModel属性已完成更新：

private static void OnIsCheckedChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    var control = (CustomToggleControl)d;
#if WINDOWS_UWP || WINUI
    // WinUI3/UWP下延迟执行，等待ViewModel属性更新
    control.DispatcherQueue.TryEnqueue(() => control.TriggerCheckCommand());
#else
    // WPF下直接执行
    control.TriggerCheckCommand();
#endif
}

2. 直接使用回调中的新值传递给命令 #

不依赖ViewModel的IsChecked属性，而是将PropertyChangedCallback参数中的e.NewValue直接作为命令参数传递，跳过对ViewModel属性的依赖：

private static void OnIsCheckedChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    var control = (CustomToggleControl)d;
    bool newCheckedValue = (bool)e.NewValue;
    // 直接传递新值给命令，无需等待ViewModel更新
    control.CheckCommand?.Execute(newCheckedValue);
}

3. 监听ViewModel的PropertyChanged事件 #

如果控件逻辑必须依赖ViewModel的属性状态，可在控件中监听ViewModel的INotifyPropertyChanged事件，当IsChecked属性变化时再执行相关逻辑：

protected override void OnDataContextChanged(DependencyPropertyChangedEventArgs e)
{
    base.OnDataContextChanged(e);
    
    if (e.OldValue is INotifyPropertyChanged oldVm)
        oldVm.PropertyChanged -= ViewModel_PropertyChanged;
    
    if (e.NewValue is INotifyPropertyChanged newVm)
        newVm.PropertyChanged += ViewModel_PropertyChanged;
}

private void ViewModel_PropertyChanged(object sender, PropertyChangedEventArgs e)
{
    if (e.PropertyName == nameof(MyViewModel.IsChecked))
    {
        var vm = (MyViewModel)sender;
        // 此时ViewModel的IsChecked已是最新值，执行控件逻辑
        UpdateControlState(vm.IsChecked);
    }
}

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