WinUI 3中ListView首个项的Checkbox无法同步服务器端修改的绑定属性值

我之前在WinUI 3项目里遇到过几乎一模一样的问题，结合你描述的细节——第一个项的TextBlock能正确显示更新后的IsComplete，但CheckBox死活不更新，而且只有手动点击过的项才会出这个问题——大概率是CheckBox的TwoWay绑定产生了本地值覆盖导致的，给你分析下原因和解决办法：

问题根源分析 #

• 当你手动点击CheckBox时，IsChecked默认是TwoWay绑定，WinUI会在这个依赖属性上设置一个本地值（Local Value）。这个本地值的优先级远高于数据上下文的绑定值，所以当你通过服务器同步替换集合里的项时，新TodoItem的IsComplete值根本没法覆盖这个本地值，导致CheckBox停留在旧状态。
• 而TextBlock的Text绑定默认是OneWay，不会产生本地值，所以能正常显示新的属性值。
• 其他没被手动点击过的项没有本地值，所以同步后能正常更新，这也对应了你观察到的现象。

具体解决方案 #

方案1：修改CheckBox的绑定模式为OneWay（最推荐）

既然你已经通过EditItemCommand来处理CheckBox的点击逻辑，完全不需要依赖TwoWay绑定自动更新属性，把IsChecked的绑定改成OneWay就能彻底避免本地值的问题：

<CheckBox
    Margin="10"
    Command="{Binding ViewModel.EditItemCommand, ElementName=ThisPage}"
    CommandParameter="{Binding Id}"
    Content="{Binding Title}"
    IsChecked="{Binding IsComplete, Mode=OneWay}" />

这样既符合你的命令式处理逻辑，又从根源上解决了绑定冲突。

方案2：给数据模型实现INotifyPropertyChanged

虽然你现在是直接替换集合里的实例，但如果后续有直接更新现有TodoItem属性的场景，数据模型必须实现属性变更通知，否则UI永远感知不到变化。修改TodoItem类：

using System.ComponentModel;
using System.Runtime.CompilerServices;

public class TodoItem : OfflineClientEntity, INotifyPropertyChanged
{
    private bool _isComplete = false;
    public string Title { get; set; } = string.Empty;
    
    public bool IsComplete
    {
        get => _isComplete;
        set
        {
            if (_isComplete != value)
            {
                _isComplete = value;
                OnPropertyChanged();
            }
        }
    }

    public event PropertyChangedEventHandler? PropertyChanged;

    protected virtual void OnPropertyChanged([CallerMemberName] string? propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    public override string ToString()
        => JsonSerializer.Serialize(this);
}

方案3：替换集合时先清空再添加（避免容器复用）

如果上面的方案还没解决问题，可以尝试把ReplaceAll换成“清空+添加”的方式，强制ListView重新生成所有项容器，避免虚拟化导致的旧容器复用：

// 替换原来的Items.ReplaceAll(itemsFromDatabase);
Items.Clear();
Items.AddRange(itemsFromDatabase);

这样能确保每个项都使用全新的容器，不会保留之前的本地值。

额外验证小技巧 #

你可以用WinUI的Live Visual Tree工具查看第一个CheckBox的IsChecked属性的值来源，如果显示是“Local Value”，那就坐实了我们的分析，直接用方案1就能解决。

备注：内容来源于stack exchange，提问作者Trevor