Xamarin中定义ObservableCollection类型可绑定属性及监听内容变更的正确方式

BindableProperty.Create() 没有提供自动监听集合内部INotifyCollectionChanged.CollectionChanged事件的内置回调，不存在可以直接完成集合内容变更监听注册的内置语法，要响应集合内部增删改操作，必须在属性值变更回调中手动完成事件的注册与注销。

完整实现代码 #

public static readonly BindableProperty MyCollectionProperty = BindableProperty.Create(
    nameof(MyContentView.MyCollection),
    typeof(ObservableCollection<object>),
    typeof(MyContentView),
    propertyChanged: OnMyCollectionPropertyChanged);

public ObservableCollection<object> MyCollection
{
    get => (ObservableCollection<object>)GetValue(MyContentView.MyCollectionProperty);
    set => SetValue(MyContentView.MyCollectionProperty, value);
}

private static void OnMyCollectionPropertyChanged(BindableObject bindable, object oldvalue, object newvalue)
{
    var view = (MyContentView)bindable;
    
    // 注销旧集合的事件订阅，避免内存泄漏
    if (oldvalue is INotifyCollectionChanged oldColl)
    {
        oldColl.CollectionChanged -= view.OnCollectionInnerChanged;
    }

    // 为新集合注册事件订阅
    if (newvalue is INotifyCollectionChanged newColl)
    {
        newColl.CollectionChanged += view.OnCollectionInnerChanged;
        // 新集合赋值完成后可主动触发一次处理逻辑，同步初始状态
        view.ProcessCollectionChange();
    }
}

private void OnCollectionInnerChanged(object sender, NotifyCollectionChangedEventArgs e)
{
    // 集合内部增删改时触发的逻辑
    ProcessCollectionChange();
}

private void ProcessCollectionChange()
{
    // 抽离公共处理逻辑，集合整体替换、内部内容变更都复用该逻辑
    // 在这里编写你的响应代码
}

关键注意点 #

• 必须注销旧集合的事件：如果省略旧值的事件解绑步骤，被替换的旧集合会因为持有当前控件的引用无法被GC回收，引发内存泄漏。
• 类型判断建议使用INotifyCollectionChanged接口而非强类型ObservableCollection<T>，后续如果替换为其他实现了该接口的自定义集合类型，代码无需修改即可兼容。
• 如果控件存在明确的销毁生命周期（比如MAUI/Forms中的Handler断开、WPF中的Unloaded事件），建议在控件销毁逻辑中额外增加一次当前集合的事件解绑，进一步规避泄漏风险。
• 不要在控件构造函数中提前注册集合事件：构造函数执行时BindableProperty的绑定值可能尚未完成赋值，无法拿到有效的集合实例。

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