WPF派生自定义控件无法继承基类样式问题咨询

问题现象 #

派生自WPF内置Button的Button2可以自动继承Button的默认样式：

public class Button2 : Button
{ 
}

但自定义控件的子类却无法继承基类样式：

public class X : ContentControl
{
    static X()
    {
        DefaultStyleKeyProperty.OverrideMetadata(typeof(X), new FrameworkPropertyMetadata(typeof(X)));
    }
}

public class Y : X
{

}

配合XAML资源定义：

<Window.Resources>
    <Style TargetType="{x:Type local:X}">
        <Style.Setters>
            <Setter Property="Template">
                <Setter.Value>
                    <ControlTemplate TargetType="{x:Type local:X}">
                        <Border Background="Red">
                            <ContentPresenter />
                        </Border>
                    </ControlTemplate>
                </Setter.Value>
            </Setter>
        </Style.Setters>
    </Style>
</Window.Resources>

<StackPanel>
    <local:X>
        <TextBlock Text="Hello world!" />
    </local:X>

    <local:Y>
        <TextBlock Text="Hello world!" />
    </local:Y>

    <local:Button2>
        <TextBlock Text="Hello world!" />
    </local:Button2>
</StackPanel>

运行后Y控件无显示效果，期望它能像Button2一样无需额外代码继承基类样式。

核心原因 #

WPF控件的样式匹配逻辑依赖于DefaultStyleKey属性：

• 内置Button的DefaultStyleKey默认是typeof(Button)，派生类Button2没有重写这个属性，所以它的DefaultStyleKey依然是typeof(Button)，会自动匹配Button的样式。
• 自定义控件X在静态构造函数中重写了DefaultStyleKeyProperty的元数据，将其设置为typeof(X)。此时子类Y的默认DefaultStyleKey会变成typeof(Y)，而你的资源中没有定义Y的样式，所以控件没有应用任何模板，自然无显示效果。

解决方案 #

要让子类自动继承基类样式，有两种可行方式：

方式1：修改基类X的样式引用逻辑 #

不在静态构造函数中重写DefaultStyleKeyProperty的元数据，而是在构造函数中直接指定样式引用：

public class X : ContentControl
{
    public X()
    {
        SetResourceReference(StyleProperty, typeof(X));
    }
}

这样无论X的子类是谁，都会直接引用X的样式，无需额外代码。

方式2：让子类继承基类的DefaultStyleKey #

在子类Y的静态构造函数中，将DefaultStyleKey重写为typeof(X)：

public class Y : X
{
    static Y()
    {
        DefaultStyleKeyProperty.OverrideMetadata(typeof(Y), new FrameworkPropertyMetadata(typeof(X)));
    }
}

这种方式更贴合WPF的默认样式查找逻辑，但需要给每个子类添加这段代码，适合子类数量不多的场景。

为什么Button不需要特殊处理？ #

因为WPF内置控件的DefaultStyleKey默认绑定的是基类类型，派生类如果不主动重写DefaultStyleKeyProperty的元数据，就会继承基类的DefaultStyleKey值。而自定义控件在创建时，通常会通过重写DefaultStyleKeyProperty元数据来关联自己的默认样式，这就导致子类的DefaultStyleKey自动指向自身类型，从而无法匹配基类样式。

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