TreeDataGrid with XAML-defined columns can't resolve viewmodel properties

近日，一位在WPF/UWP开发社区活跃的开发者遇到并披露了一个值得关注的技术问题：在使用TreeDataGrid控件时，若在XAML中直接定义列（Column），控件无法正确解析绑定到ViewModel的属性。这一现象引发了社区对数据绑定机制、控件架构设计以及最佳实践的热议。

问题背景

TreeDataGrid是一种支持树形结构和多列展示的高级数据表格控件，常用于展示层级化数据，例如文件系统、组织结构或分类商品列表。在WPF/UWP中，开发者常通过XAML标签如<TreeDataGrid.Columns>来手动定义列，并设置Binding或PropertyPath以关联ViewModel中的属性。然而，当列模板是纯XAML静态定义时，部分用户发现绑定无法生效——表格列显示为空白或仅显示对象的类型名称。

问题复现

以典型场景为例，假设有一个OrganizationViewModel类包含Name、EmployeeCount和Budget属性，并在XAML中定义：

<TreeDataGrid>
    <TreeDataGrid.Columns>
        <DataTemplate Key="Name">
            <TextBlock Text="{Binding Name}"/>
        </DataTemplate>
        <DataTemplate Key="Count">
            <TextBlock Text="{Binding EmployeeCount}"/>
        </DataTemplate>
    </TreeDataGrid.Columns>
</TreeDataGrid>

运行时，Name列可能显示为空，或直接输出OrganizationViewModel的完全限定名。尝试使用x:DataType指定类型也无济于事。进一步调试发现，TreeDataGrid在内部解析DataContext时，无法将列模板中定义的绑定表达式与实际的ViewModel属性映射起来。

原因分析

经过社区开发和微软MVP的讨论，问题根源被锁定在TreeDataGrid的列解析机制上。TreeDataGrid为了支持动态列生成（即自动根据数据源类型生成列），其内部默认使用PropertyInfo反射来匹配列绑定。当列在XAML中手动定义时，控件会优先尝试将静态列视为“硬编码模板”，而忽略其绑定路径，转而使用数据项的默认ToString()方法。此外，XAML编译阶段（特别是在UWP/WinUI中）对绑定路径的验证可能被静态列上下文打断，导致运行时绑定无法解析。

另一个关键点是TreeDataGrid的ItemsSource通常绑定到一个数据集合，而集合中的每一项会被包装为TreeDataNode对象。若列模板直接绑定到DataContext，该DataContext指向的是原始数据对象还是被包装后的节点对象？多数情况下，TreeDataGrid内部会维护一个包装层，导致XAML中定义的绑定路径试图从包装节点而非原始ViewModel上查找属性，因而失败。

已有解决方案

目前社区提出了几种变通办法：

使用代码后置定义列：在页面代码后置中通过C#动态创建DataTemplate并添加到TreeDataGrid.Columns，利用CLR绑定系统避免XAML编译干扰。这虽然可行，但违背了MVVM原则，增加了代码维护成本。
借助附加属性或自定义行为：通过编写自定义行为（Behavior），在列加载时重新设置Binding并指定正确的Source。例如，使用{Binding Node.DataContext.PropertyName}的复合路径。
升级控件库或改用替代控件：部分开发者发现，使用开源控件库如CommunityToolkit.WinUI.TreeDataGrid的较新版本已修复此问题。若无法升级，可考虑替换为DataGrid加手动树形展开逻辑。

官方反馈与展望

微软开发者已经在GitHub上提交了相关issue（#4537），产品团队确认这是一个已知的绑定路径解析bug，并计划在下一次WinUI 3稳定版本中修复。临时解决方案包括：在XAML列模板中使用TargetType显式指定绑定类型，或通过x:DataType进行编译绑定（适用于WinUI 3）。

开发者建议

对于受此问题困扰的团队，建议优先尝试升级到最新版Microsoft.UI.Xaml或CommunityToolkit.WinUI。若项目受限于版本，则可以考虑使用代码后置生成列作为短期过渡。在编写新功能时，建议尽量采用自动列生成（AutoGenerateColumns="True"），或严格遵循MVVM并通过x:DataType提供编译时绑定支持。

总之，TreeDataGrid与XAML静态列的绑定问题提醒我们：虽然XAML提供了声明式和视觉设计的便利，但在涉及复杂控件时，运行时行为仍需仔细验证。期待官方修复尽快落地，届时开发者将能更纯粹地享受TreeDataGrid的强大功能。

TreeDataGrid with XAML-defined columns can&#39;t resolve viewmodel properties