使用DependencyProperty时ObservableCollection新增元素不更新视图

核心原因 #

1. DependencyProperty的感知范围限制：DependencyProperty仅监听整个集合实例的替换（比如ViewModel把People从旧的ObservableCollection换成新的），但不会自动感知集合内部元素的添加/删除——因为ObservableCollection的CollectionChanged事件是独立于DependencyProperty变更通知的。
2. 自定义控件未正确订阅集合内部变更：如果你的UserControl没有在DependencyProperty的实例变化时，订阅新集合的CollectionChanged事件，那么集合内部的元素变动就无法传递到UI层。
3. 绑定配置错误：UserControl内部控件（如ListBox）的ItemsSource绑定路径不正确，或者绑定模式、数据源上下文设置错误，导致无法接收到集合变更通知。

解决办法 #

1. 给DependencyProperty添加变更回调，订阅集合内部事件 #

在注册DependencyProperty时，通过PropertyMetadata指定PropertyChangedCallback，在回调中处理集合的订阅/取消订阅，确保集合内部变动能触发UI更新：

public partial class YourCustomControl : UserControl
{
    public static readonly DependencyProperty PeopleProperty =
        DependencyProperty.Register(
            nameof(People),
            typeof(ObservableCollection<Person>),
            typeof(YourCustomControl),
            new PropertyMetadata(null, OnPeoplePropertyChanged));

    public ObservableCollection<Person> People
    {
        get => (ObservableCollection<Person>)GetValue(PeopleProperty);
        set => SetValue(PeopleProperty, value);
    }

    private static void OnPeoplePropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        var control = (YourCustomControl)d;
        
        // 取消旧集合的事件订阅，避免内存泄漏
        if (e.OldValue is ObservableCollection<Person> oldPeople)
        {
            oldPeople.CollectionChanged -= control.PeopleCollectionChanged;
        }
        
        // 订阅新集合的变更事件
        if (e.NewValue is ObservableCollection<Person> newPeople)
        {
            newPeople.CollectionChanged += control.PeopleCollectionChanged;
            // 首次加载时手动同步UI（可选，确保初始数据显示）
            control.SyncPeopleUI();
        }
    }

    private void PeopleCollectionChanged(object sender, NotifyCollectionChangedEventArgs e)
    {
        // 触发绑定控件的更新，确保UI同步
        if (FindName("PeopleList") is ItemsControl listControl)
        {
            listControl.GetBindingExpression(ItemsControl.ItemsSourceProperty)?.UpdateTarget();
        }
    }

    private void SyncPeopleUI()
    {
        // 可在这里处理初始数据的UI渲染逻辑
        (FindName("PeopleList") as ItemsControl)?.Items.Refresh();
    }
}

2. 确保UserControl内部绑定正确 #

在UserControl的XAML中，确保ItemsControl的ItemsSource正确绑定到DependencyProperty，避免DataContext覆盖导致绑定失效：

<UserControl x:Class="YourNamespace.YourCustomControl"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:YourNamespace">
    <Grid>
        <!-- 使用RelativeSource绑定到UserControl自身的People属性 -->
        <ListBox x:Name="PeopleList"
                 ItemsSource="{Binding RelativeSource={RelativeSource AncestorType=local:YourCustomControl}, Path=People}" />
    </Grid>
</UserControl>

注意：不要把ViewModel直接设置为UserControl的DataContext，否则RelativeSource绑定会失效。如果需要使用ViewModel作为DataContext，可通过绑定路径指定到父级的DependencyProperty。

3. ViewModel中保持ObservableCollection实例不变 #

ViewModel里不要每次添加元素时重新实例化ObservableCollection，要复用同一个实例：

// 正确写法：初始化一次，后续仅修改内部元素
public class MainViewModel
{
    public ObservableCollection<Person> People { get; } = new ObservableCollection<Person>();

    public void AddNewPerson()
    {
        People.Add(new Person { Name = "New Person" });
    }
}

如果频繁替换集合实例，不仅会浪费内存，还会导致UI频繁重建，不符合WPF的绑定设计原则。

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