自定义依赖属性绑定异常：无法找到所属FrameworkElement/FrameworkContentElement

核心结论 #

WPF完全支持类型为DependencyObject的依赖属性，但你遇到的绑定异常，根源是独立的DependencyObject没有关联到宿主控件的逻辑树/命名范围，导致绑定引擎无法解析ElementName。

为什么会触发这个异常？ #

当你使用ElementName进行绑定时，绑定需要依赖一个FrameworkElement或FrameworkContentElement作为上下文（即所谓的"governing element"），以此来查找命名空间内的目标元素。你的ICTextBoxHelperText只是单纯继承DependencyObject，没有被加入宿主ICTextBox的逻辑树，也没有继承宿主的上下文，所以绑定引擎找不到你指定的ElementName对应的控件实例。

两种可行的解决方案 #

方案1：改用Freezable作为分组类型（推荐）

Freezable是DependencyObject的子类，WPF为它设计了**继承上下文（Inheritance Context）**机制——只要Freezable对象被作为某个FrameworkElement的依赖属性值，它会自动继承该元素的DataContext和命名范围，完美解决绑定上下文问题。

修改ICTextBoxHelperText的实现：

public class ICTextBoxHelperText : Freezable
{
    // 必须重写的方法，返回当前类型的新实例
    protected override Freezable CreateInstanceCore()
    {
        return new ICTextBoxHelperText();
    }

    // 你的子依赖属性示例
    public string Default
    {
        get => (string)GetValue(DefaultProperty);
        set => SetValue(DefaultProperty, value);
    }
    public static readonly DependencyProperty DefaultProperty =
        DependencyProperty.Register(nameof(Default), typeof(string), typeof(ICTextBoxHelperText));

    // 其他子依赖属性...
}

修改后，原有的ElementName绑定就能正常工作，无需额外处理上下文关联。

方案2：手动关联逻辑树与DataContext

如果你坚持使用DependencyObject作为基类，可以在宿主控件的HelperText属性变更时，手动将ICTextBoxHelperText加入逻辑树，并同步DataContext：

public class ICTextBox : TextBox
{
    public static readonly DependencyProperty HelperTextProperty =
        DependencyProperty.Register(nameof(HelperText), typeof(ICTextBoxHelperText), typeof(ICTextBox),
            new PropertyMetadata(null, OnHelperTextChanged));

    public ICTextBoxHelperText HelperText
    {
        get => (ICTextBoxHelperText)GetValue(HelperTextProperty);
        set => SetValue(HelperTextProperty, value);
    }

    private static void OnHelperTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        var textBox = (ICTextBox)d;
        
        // 移除旧的HelperText实例
        if (e.OldValue is DependencyObject oldHelper)
        {
            textBox.RemoveLogicalChild(oldHelper);
        }
        
        // 添加新的HelperText实例到逻辑树，并同步DataContext
        if (e.NewValue is DependencyObject newHelper)
        {
            newHelper.SetValue(DataContextProperty, textBox.DataContext);
            textBox.AddLogicalChild(newHelper);
        }
    }
}

这种方式需要手动维护逻辑树的生命周期，不如Freezable方案简洁，仅在特殊场景下使用。

关于分组依赖属性的合理性 #

你这种将同类依赖属性分组的设计是完全合理的，WPF官方控件也广泛采用类似模式（比如Control.Margin、TextBlock.TextEffects等结构型属性），既避免了控件类属性过多导致的混乱，又能保持属性的关联性。

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