使用TemplateBinding绑定整数无显示问题求助

问题场景 #

自定义控件的int类型依赖属性绑定到ControlTemplate内的TextBlock时，界面无内容显示；将属性类型改为string后，绑定正常生效。

核心原因 #

TextBlock的Text属性要求string类型，虽然WPF支持基础数值类型到字符串的自动转换，但在TemplateBinding或使用RelativeSource=TemplatedParent的绑定场景中，若未显式指定转换规则，自动转换可能未触发，导致整数无法渲染为文本。

解决方案 #

方案1：绑定中添加StringFormat

这是最简单的解决方式，通过StringFormat显式指定整数转字符串的格式：

• 使用TemplateBinding的写法：

<TextBlock FontSize="14"
           Foreground="#000"
           Text="{TemplateBinding Number, StringFormat='{0}'}"/>

• 使用RelativeSource的写法：

<TextBlock FontSize="14"
           Foreground="#000"
           Text="{Binding Number, RelativeSource={RelativeSource TemplatedParent}, StringFormat='{0}', TargetNullValue=''}"/>

方案2：使用值转换器（适用于复杂转换场景）

如果需要自定义转换逻辑（比如格式化数字、处理特殊值），可以实现IValueConverter：

1. 创建转换器类：

public class IntToStringConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return value is int intValue ? intValue.ToString() : string.Empty;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return int.TryParse(value?.ToString(), out int result) ? result : 0;
    }
}

2. 在XAML资源中声明转换器：

<local:IntToStringConverter x:Key="IntToStringConverter"/>

3. 在绑定中引用转换器：

<TextBlock FontSize="14"
           Foreground="#000"
           Text="{TemplateBinding Number, Converter={StaticResource IntToStringConverter}}"/>

补充说明 #

当属性类型改为string时，绑定直接匹配TextBlock的Text属性类型，无需转换即可生效，因此能正常显示内容。

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