ControlTemplate中模板绑定的转换器为何无法生效？

我创建了一个包含Border的ControlTemplate，希望通过模板绑定（TemplateBinding）为其绑定Background属性，同时需要为SolidColorBrush设置x:Name属性。因此我编写了一个将Brush转换为Color的简易转换器，但该转换器无法生效，不清楚原因。

我的XAML代码 #

<ControlTemplate TargetType="Button" x:Key="appBtns">
    <ControlTemplate.Resources>
        <local:ColorConverter x:Key="ColorConverter"/>
    </ControlTemplate.Resources>
    <Border x:Name="BackRect" CornerRadius="15" BorderThickness="0" Height="{TemplateBinding Height}" Width="{TemplateBinding Width}">
        <Border.Background >
            <SolidColorBrush x:Name="BackRectColor" Color="{TemplateBinding Background, Converter={StaticResource ColorConverter}}"/>
        </Border.Background>
    </Border>
</ControlTemplate>

我的转换器代码 #

public class ColorConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return ((SolidColorBrush)value).Color;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return value;
    }
}

核心原因 #

TemplateBinding是轻量级绑定机制，仅支持直接绑定模板父控件的属性，无法在SolidColorBrush这类Freezable对象内部配合转换器使用——其解析逻辑限制导致转换器无法被正确触发。

修复方案 #

1. 替换绑定方式：将TemplateBinding替换为RelativeSource=TemplatedParent的完整绑定，让转换器能在SolidColorBrush内部正常工作。
2. 完善转换器安全判断：增加空值和类型校验，避免强制转换引发的空引用异常。

修改后的XAML代码

<ControlTemplate TargetType="Button" x:Key="appBtns">
    <ControlTemplate.Resources>
        <local:ColorConverter x:Key="ColorConverter"/>
    </ControlTemplate.Resources>
    <Border x:Name="BackRect" CornerRadius="15" BorderThickness="0" 
            Height="{TemplateBinding Height}" Width="{TemplateBinding Width}">
        <Border.Background >
            <SolidColorBrush x:Name="BackRectColor" 
                Color="{Binding Background, RelativeSource={RelativeSource TemplatedParent}, Converter={StaticResource ColorConverter}}"/>
        </Border.Background>
    </Border>
</ControlTemplate>

修改后的转换器代码

public class ColorConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is SolidColorBrush brush)
        {
            return brush.Color;
        }
        return Colors.Transparent;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is Color color)
        {
            return new SolidColorBrush(color);
        }
        return new SolidColorBrush(Colors.Transparent);
    }
}

额外简化方案 #

如果不需要后续通过代码单独控制这个SolidColorBrush，完全可以省略转换器，直接绑定Background属性：

<Border x:Name="BackRect" CornerRadius="15" BorderThickness="0" 
        Height="{TemplateBinding Height}" Width="{TemplateBinding Width}"
        Background="{TemplateBinding Background}">
</Border>

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