WPF TreeView绑定异常：ToString未调用，下拉项空白，编程加载正常

问题描述 #

使用WPF TreeView时，通过数据绑定加载数据：

• TreeDiagram的ToString()方法从未被调用
• 下拉子项显示空白，但CategoryName可正常显示
• 以编程方式加载相同数据时，所有功能正常

因需求限制必须使用绑定方式，尝试过通过IValueConverter将对象集合转换为字符串集合，但未生效，询问操作错误点。

相关代码 #

类定义

public class TreeDiagram : INotifyPropertyChanged
{
    public string CategoryName
    {...}

    public ObservableCollection<ImageInfo> DiagramsTRV
    {...}

    public class ImageInfo : INotifyPropertyChanged
    {
        public string Category
        { ...}

        public override string ToString()
        {
            return DisplayName;
        }

        public string DisplayName
        {...}

        public ObservableCollection<TreeDiagram> TreeDiagrams {...}
    }
}

XAML代码

<StackPanel Orientation="Vertical">
    <StackPanel Orientation="Horizontal">
        <StackPanel Orientation="Vertical">
            <TextBlock Text="Binding"/>
            <TreeView  x:Name="trvDiagrams" Width="300" Height="400" ItemsSource="{Binding TreeDiagrams}" HorizontalAlignment="Left">
                <TreeView.ItemTemplate>
                    <HierarchicalDataTemplate DataType="x:Type local:TreeDiagram" ItemsSource="{Binding DiagramsTRV, UpdateSourceTrigger=PropertyChanged}">
                        <TextBlock Width="250" Text="{Binding CategoryName, UpdateSourceTrigger=PropertyChanged}"/>
                    </HierarchicalDataTemplate>
                </TreeView.ItemTemplate>
            </TreeView>
        </StackPanel>
        <StackPanel Orientation="Vertical">
            <TextBox Text="No Binding"/>
            <TreeView x:Name="trvNoBind" Width="300" Height="400" HorizontalAlignment="Right">
            </TreeView>
        </StackPanel>
    </StackPanel>
</StackPanel>

效果对比 #

问题原因与解决方案 #

核心问题

你只给TreeDiagram类型定义了HierarchicalDataTemplate，但没有为子项的ImageInfo类型指定任何数据模板。绑定DiagramsTRV（ObservableCollection<ImageInfo>）时，WPF无法识别如何渲染ImageInfo对象，即便ImageInfo重写了ToString()，绑定场景下也不会自动触发该方法生成显示内容，导致子项空白。

解决方案1：为ImageInfo添加全局数据模板

在XAML的资源区域（如Window.Resources或TreeView.Resources）中添加针对ImageInfo的DataTemplate，让WPF自动识别并渲染该类型对象：

<Window.Resources>
    <DataTemplate DataType="{x:Type local:ImageInfo}">
        <TextBlock Text="{Binding DisplayName}"/>
    </DataTemplate>
</Window.Resources>

解决方案2：在HierarchicalDataTemplate内指定子项模板

如果不想定义全局模板，也可以直接在TreeDiagram的HierarchicalDataTemplate中设置子项的模板：

<HierarchicalDataTemplate DataType="x:Type local:TreeDiagram" ItemsSource="{Binding DiagramsTRV}">
    <TextBlock Text="{Binding CategoryName}"/>
    <!-- 为ImageInfo子项指定渲染模板 -->
    <HierarchicalDataTemplate.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding DisplayName}"/>
        </DataTemplate>
    </HierarchicalDataTemplate.ItemTemplate>
</HierarchicalDataTemplate>

关于IValueConverter失效的说明

你尝试用IValueConverter将ImageInfo集合转为字符串集合的方式无效，是因为转换后的字符串没有对应的渲染模板，且这种方式破坏了数据对象的原始结构，远不如直接为ImageInfo定义模板的方式优雅可靠。

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