如何为Brush类型的DependencyProperty设置合法默认值

你当前的报错和默认值设置失败是三个问题叠加导致的：

• 静态字段初始化顺序错误：C#类的静态字段按代码书写顺序初始化，你先写了PatternBrushProperty的注册逻辑，后定义defaultPatternBrush字段，执行依赖属性注册时，defaultPatternBrush还未完成初始化。
• 类型转换上下文缺失：ColorConverter.ConvertFromString依赖WPF运行时的类型描述上下文，这个上下文在类静态初始化阶段还未就绪，直接强转转换结果就会抛出'#FFC5D4E3' is not a valid value for property 'Color'异常。
• 隐藏的共享实例风险：SolidColorBrush是Freezable类型，如果直接把单个静态Brush实例作为依赖属性默认值，会被所有该控件的实例共享，任意一处修改这个Brush的属性，所有控件的显示都会被连带影响。

不能在依赖属性静态注册阶段直接引用资源字典中的画刷。
依赖属性注册是在类型的静态初始化阶段执行的，此时控件实例还未创建，没有可用于资源查找的逻辑树/视觉树上下文，根本无法访问资源字典中定义的资源，因此不能直接在UIPropertyMetadata中传入资源字典的Brush作为默认值。

根据你的需求二选一即可：

方案1：硬编码默认画刷（无资源依赖，性能最好） #

通过ARGB值直接创建画刷，冻结后作为默认值，既绕开类型转换问题，也解决静态初始化顺序和实例共享问题，代码如下：

public Brush PatternBrush
{
    get => (Brush)GetValue(PatternBrushProperty);
    set => SetValue(PatternBrushProperty, value);
}

// 静态字段必须定义在依赖属性注册逻辑之前
private static readonly SolidColorBrush _defaultPatternBrush = new(
    Color.FromRgb(0xC5, 0xD4, 0xE3)
);

// 在静态构造函数中完成依赖属性注册，确保默认画刷已初始化
static MyCustomControl()
{
    _defaultPatternBrush.Freeze(); // 冻结画刷为只读，可安全全局共享
    PatternBrushProperty = DependencyProperty.Register(
        nameof(PatternBrush),
        typeof(Brush),
        typeof(MyCustomControl),
        new UIPropertyMetadata(_defaultPatternBrush)
    );
}

public static readonly DependencyProperty PatternBrushProperty;

方案2：使用资源字典中的画刷作为默认值 #

如果需要通过资源字典统一管控画刷资源，不要在依赖属性元数据中设置默认画刷，改为在控件实例化时，仅当属性未被显式赋值时从资源加载对应画刷即可：

public class MyCustomControl : Control
{
    public Brush PatternBrush
    {
        get => (Brush)GetValue(PatternBrushProperty);
        set => SetValue(PatternBrushProperty, value);
    }

    public static readonly DependencyProperty PatternBrushProperty =
        DependencyProperty.Register(
            nameof(PatternBrush), 
            typeof(Brush), 
            typeof(MyCustomControl),
            new UIPropertyMetadata(null) // 元数据中默认值暂设为null
        );

    public MyCustomControl()
    {
        // 判断当前属性值是否为系统默认值（即用户/样式未显式赋值）
        var valueSource = DependencyPropertyHelper.GetValueSource(this, PatternBrushProperty);
        if (valueSource.BaseValueSource == BaseValueSource.Default)
        {
            // 替换为你资源字典中对应画刷的Key
            if (TryFindResource("DefaultPatternBrush") is Brush resourceBrush)
            {
                // 使用SetCurrentValue赋值，不会覆盖后续样式、显式赋值的优先级
                SetCurrentValue(PatternBrushProperty, resourceBrush);
            }
        }
    }
}

提示：如果你的画刷定义在主题资源字典（Generic.xaml）中，要确保控件已正确重写默认样式键，保证资源查找路径正常。

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