Xamarin.Forms中ObservableDictionary双向绑定后UI不更新问题

看起来你遇到的是ObservableDictionary双向绑定中集合变更通知未正确触发的典型问题，结合你描述的现象（构造时数据正常显示，后续更新字典UI无同步），我帮你梳理几个关键的排查点和解决方案：

1. 先检查：你的ObservableDictionary实现是否正确？ #

绝大多数这类问题的根源，是自定义的ObservableDictionary没有完整实现INotifyCollectionChanged和INotifyPropertyChanged接口。比如很多简单实现只处理了Add/Remove操作的事件触发，却漏掉了**值修改（索引器赋值）**的变更通知。

给你一个能正确触发所有变更事件的实现模板：

public class ObservableDictionary<TKey, TValue> : IDictionary<TKey, TValue>, 
    INotifyCollectionChanged, INotifyPropertyChanged
{
    private readonly Dictionary<TKey, TValue> _innerDict = new Dictionary<TKey, TValue>();

    public event NotifyCollectionChangedEventHandler CollectionChanged;
    public event PropertyChangedEventHandler PropertyChanged;

    // 索引器：处理值修改的变更通知
    public TValue this[TKey key]
    {
        get => _innerDict[key];
        set
        {
            if (_innerDict.TryGetValue(key, out var oldValue) && 
                EqualityComparer<TValue>.Default.Equals(oldValue, value))
                return;

            _innerDict[key] = value;
            // 触发Replace事件，通知UI更新该项
            OnCollectionChanged(new NotifyCollectionChangedEventArgs(
                NotifyCollectionChangedAction.Replace, 
                new KeyValuePair<TKey, TValue>(key, value), 
                new KeyValuePair<TKey, TValue>(key, oldValue)));
            OnPropertyChanged(nameof(Count));
        }
    }

    // Add操作的事件触发
    public void Add(TKey key, TValue value)
    {
        _innerDict.Add(key, value);
        OnCollectionChanged(new NotifyCollectionChangedEventArgs(
            NotifyCollectionChangedAction.Add, 
            new KeyValuePair<TKey, TValue>(key, value)));
        OnPropertyChanged(nameof(Count));
    }

    // Remove操作的事件触发
    public bool Remove(TKey key)
    {
        if (_innerDict.TryGetValue(key, out var value) && _innerDict.Remove(key))
        {
            OnCollectionChanged(new NotifyCollectionChangedEventArgs(
                NotifyCollectionChangedAction.Remove, 
                new KeyValuePair<TKey, TValue>(key, value)));
            OnPropertyChanged(nameof(Count));
            return true;
        }
        return false;
    }

    // 实现IDictionary的其他必要方法（比如ContainsKey、Clear等），这里省略...

    protected virtual void OnCollectionChanged(NotifyCollectionChangedEventArgs e)
    {
        CollectionChanged?.Invoke(this, e);
    }

    protected virtual void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

2. 把字段改成属性，确保绑定引擎能监听 #

你代码里的DataDict是字段而非属性，Xamarin/.NET MAUI的绑定引擎默认只监听公共属性的变更，字段的绑定仅在初始化时有效，后续变更不会被感知。修改你的TestPage代码：

public class TestPage : ContentPage, INotifyPropertyChanged
{
    // 改成私有字段+公共属性
    private ObservableDictionary<int, string> _dataDict;
    public ObservableDictionary<int, string> DataDict
    {
        get => _dataDict;
        set
        {
            if (_dataDict != value)
            {
                _dataDict = value;
                OnPropertyChanged(nameof(DataDict));
            }
        }
    }

    public TestPage()
    {
        DataDict = new ObservableDictionary<int, string>();
        // 必须设置BindingContext，让UI找到数据源
        BindingContext = this;
        
        // 初始化测试数据
        DataDict.Add(1, "初始项1");
        DataDict.Add(2, "初始项2");

        // 这里添加你的UI布局代码，比如CollectionView绑定DataDict
        var collectionView = new CollectionView
        {
            ItemsSource = DataDict,
            ItemTemplate = new DataTemplate(() =>
            {
                var label = new Label();
                label.SetBinding(Label.TextProperty, "Value");
                return label;
            })
        };
        Content = collectionView;
    }

    // 实现INotifyPropertyChanged接口
    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    // 测试后续更新的方法
    private void UpdateDictionary()
    {
        // 修改已有值
        DataDict[1] = "更新后的项1";
        // 添加新项
        DataDict.Add(3, "新添加的项3");
        // 删除项
        DataDict.Remove(2);
    }
}

3. 最后确认绑定路径是否正确 #

如果你的UI用了ItemTemplate，要确保绑定的是字典项的Key或Value（因为ObservableDictionary的元素是KeyValuePair<TKey,TValue>），比如上面代码里的label.SetBinding(Label.TextProperty, "Value");。

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