自定义控件DependencyProperty无法保存属性修改，求排查原因

我在自定义控件里用DependencyProperty存储字符串集合，定义代码如下：

public static readonly DependencyProperty ItemsSourceProperty = DependencyProperty.Register( 
    nameof( ItemsSource ), 
    typeof( IEnumerable<string> ), 
    typeof( MyClass), 
    new FrameworkPropertyMetadata( new List<string>() , FrameworkPropertyMetadataOptions.BindsTwoWayByDefault ) 
);

在ItemsSource的属性实现中，我尝试过滤掉已选择的字符串：通过SetValue方法把source.Except(target).ToList()的结果赋值给这个DependencyProperty，然后返回GetValue的结果。过滤逻辑本身是对的，但结果始终没保存到DependencyProperty里，请问问题出在哪？

这问题的核心是你误解了WPF DependencyProperty属性包装器的作用——属性包装器只是给你提供了便捷访问GetValue/SetValue的方式，绝对不能在里面添加业务逻辑（比如修改值、过滤后返回）。

具体问题分析： #

1. 属性包装器的执行时机问题：
   WPF在处理绑定、样式、动画这些场景时，会直接调用GetValue和SetValue方法，完全绕开你写的CLR属性包装器。你在get方法里调用SetValue修改值，然后返回过滤后的结果，这会导致：

   • WPF属性系统里存储的实际值和你返回的值不一致
   • 你通过包装器修改的值，不会被WPF的属性变更通知机制正确捕获，自然也不会同步到绑定目标或者控件内部状态

2. 默认值的潜在坑（顺带提一下）：
   你用new List<string>()作为DependencyProperty的默认值，这是引用类型实例——所有MyClass的控件实例都会共享同一个列表对象，一旦某个实例修改了这个列表，所有实例都会受到影响，这几乎肯定不是你想要的效果。

正确的解决思路： #

我们需要把原始数据存储和过滤后的数据展示分开，不要直接修改原始的ItemsSource：

1. 还原属性包装器的纯净性

首先把ItemsSource的属性包装器改回最基础的样子，只做GetValue/SetValue的转发：

public IEnumerable<string> ItemsSource
{
    get => (IEnumerable<string>)GetValue(ItemsSourceProperty);
    set => SetValue(ItemsSourceProperty, value);
}

2. 单独处理过滤逻辑

创建一个专门的属性来承载过滤后的结果，然后监听ItemsSource和已选值（假设叫SelectedItems）的变化，自动更新过滤结果：

首先，先修正ItemsSourceProperty的注册，添加属性变更回调，同时把默认值改成null避免共享集合问题：

public static readonly DependencyProperty ItemsSourceProperty = DependencyProperty.Register(
    nameof(ItemsSource),
    typeof(IEnumerable<string>),
    typeof(MyClass),
    new FrameworkPropertyMetadata(
        null, // 默认值设为null
        FrameworkPropertyMetadataOptions.BindsTwoWayByDefault,
        OnItemsSourceChanged // 添加属性变更回调
    )
);

然后，假设你已经有SelectedItems的DependencyProperty，同样添加变更回调：

public static readonly DependencyProperty SelectedItemsProperty = DependencyProperty.Register(
    nameof(SelectedItems),
    typeof(IEnumerable<string>),
    typeof(MyClass),
    new FrameworkPropertyMetadata(
        null,
        FrameworkPropertyMetadataOptions.BindsTwoWayByDefault,
        OnSelectedItemsChanged
    )
);

public IEnumerable<string> SelectedItems
{
    get => (IEnumerable<string>)GetValue(SelectedItemsProperty);
    set => SetValue(SelectedItemsProperty, value);
}

接下来，添加一个用于显示的过滤后属性，同时实现INotifyPropertyChanged接口来通知UI更新：

// 过滤后的集合，绑定到你的控件显示元素
public IEnumerable<string> FilteredItems { get; private set; }

// 实现INotifyPropertyChanged
public event PropertyChangedEventHandler PropertyChanged;

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

最后，实现变更回调和更新逻辑：

private static void OnItemsSourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    ((MyClass)d).UpdateFilteredItems();
}

private static void OnSelectedItemsChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    ((MyClass)d).UpdateFilteredItems();
}

private void UpdateFilteredItems()
{
    // 处理null的情况，避免空引用
    var allItems = ItemsSource ?? Enumerable.Empty<string>();
    var selectedItems = SelectedItems ?? Enumerable.Empty<string>();
    
    // 执行过滤逻辑
    FilteredItems = allItems.Except(selectedItems).ToList();
    
    // 通知UI更新
    OnPropertyChanged(nameof(FilteredItems));
}

这样，你的ItemsSource始终存储原始的可选值，过滤后的结果放在FilteredItems里供UI绑定，既符合WPF的属性系统设计，也能正确实现你的需求。

内容的提问来源于stack exchange，提问作者Joe M. Doe