TabControl ContentTemplate中自定义UserControl依赖属性绑定异常

问题现象 #

自定义ProfileParameterButton用户控件（包含DependencyProperty），在TabControl.ContentTemplate的DataTemplate中使用时，数据绑定始终固定在第一个Tab的对象上，但同模板内的TextBox数据绑定工作正常。排查发现所有Tab会复用同一个ProfileParameterButton实例，推测与UI虚拟化有关。

代码问题定位 #

问题出在ProfileParameterButton的依赖属性变更回调方法OnProfileParameterChanged中：

private static void OnProfileParameterChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    if (d is ProfileParameterButton instance)
    {
        // ... 事件解绑/绑定逻辑
        instance.ProfileParameter = e.NewValue as IProfileParameter; // 这行是错误根源
        instance.ModeChanged();
    }
    else throw new InvalidOperationException();
}

原因说明 #

• 依赖属性的CLR包装器（ProfileParameter属性）仅应调用GetValue/SetValue，不应在属性变更回调中手动给CLR属性赋值。
• 手动赋值instance.ProfileParameter = e.NewValue会覆盖WPF的数据绑定关系，当TabControl复用控件实例时，新的绑定无法生效，导致控件始终保留第一个Tab的数据。
• TextBox正常是因为它的绑定由WPF原生处理，没有手动干扰绑定逻辑。

解决方案 #

步骤1：修复依赖属性变更回调 #

移除手动赋值CLR属性的代码，依赖属性系统会自动同步值：

private static void OnProfileParameterChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    if (d is ProfileParameterButton instance)
    {
        // 移除旧值的事件监听
        if (e.OldValue is INotifyPropertyChanged oldNPC)
        {
            oldNPC.PropertyChanged -= instance.ProfileParameter_PropertyChanging;
        }
        // 添加新值的事件监听
        if (e.NewValue is IProfileParameter newNPC)
        {
            newNPC.PropertyChanged += instance.ProfileParameter_PropertyChanging;
        }
        // 直接更新控件状态，无需手动赋值CLR属性
        instance.ModeChanged();
    }
    else throw new InvalidOperationException();
}

步骤2：补充控件卸载时的事件清理（可选，防止内存泄漏） #

在ProfileParameterButton的构造函数中添加Unloaded事件处理，确保控件被卸载时解绑事件：

public ProfileParameterButton()
{
    InitializeComponent();
    Unloaded += ProfileParameterButton_Unloaded;
}

private void ProfileParameterButton_Unloaded(object sender, RoutedEventArgs e)
{
    if (ProfileParameter is INotifyPropertyChanged npc)
    {
        npc.PropertyChanged -= ProfileParameter_PropertyChanging;
    }
}

步骤3：确保CLR属性包装器的正确性 #

CLR属性必须严格仅调用GetValue和SetValue，不能添加额外逻辑：

public IProfileParameter? ProfileParameter
{
    get { return (IProfileParameter?)GetValue(ProfileParameterProperty); }
    set { SetValue(ProfileParameterProperty, value); }
}

验证修改 #

修改后，TabControl切换时，ProfileParameterButton会正确接收当前Tab的数据上下文，绑定关系正常更新，控件状态（ToolTip、IsEnabled）会随当前Tab的ProfileParameter变化而更新。

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