BindingProxy 与 Freezable 使用说明

BindingProxy 与 Freezable 使用说明

一、解决了什么问题

在 WPF 中，DataGridTextColumn、DataGridComboBoxColumn 等列控件不在视觉树（Visual Tree）中，因此它们无法自动继承父级容器（如 DataGrid、Window）的 DataContext。

例如，下面的 XAML 绑定会失败：

<DataGridTextColumn
    Visibility="{Binding DataContext.ColumnVisibility, RelativeSource={RelativeSource AncestorType=DataGrid}}" />

因为 DataGridTextColumn 不属于视觉树，RelativeSource 绑定无法向上查找 DataContext。

BindingProxy 通过继承 Freezable 来绕过这个限制，充当数据绑定的桥梁。

---

二、Freezable 的原理

Freezable 是 WPF 中的一个特殊基类，它具有以下关键特性：

特性	说明
继承 DataContext	Freezable 对象可以继承其父级视觉元素的 DataContext，即使它本身不在视觉树中
支持依赖属性	Freezable 继承自 DependencyObject，可定义 DependencyProperty
可冻结（Freeze）	调用 Freeze() 后变为只读、线程安全，可提升性能
可作为资源	可以在 XAML 的 <ResourceDictionary> 中定义和使用

核心机制：当一个 Freezable 被用作资源（StaticResource / DynamicResource）时，WPF 会将其与所在的视觉元素树关联，使其能够通过 Freezable 的 DataContext 继承机制获取到正确的上下文。

---

三、BindingProxy 的实现

public class BindingProxy : Freezable
{
    protected override Freezable CreateInstanceCore() => new BindingProxy();

    public object Data
    {
        get => GetValue(DataProperty);
        set => SetValue(DataProperty, value);
    }

    public static readonly DependencyProperty DataProperty =
        DependencyProperty.Register(nameof(Data), typeof(object), typeof(BindingProxy));
}

关键点

1. 继承 Freezable — 使得该类的实例能继承父级的 DataContext。
2. 必须重写 CreateInstanceCore() — Freezable 是抽象类，必须提供此方法。Freezable 内部可能通过该方法克隆实例。
3. 定义 Data 依赖属性 — 用于存储绑定的数据源，供其他非视觉树元素引用。

---

四、如何使用 BindingProxy

步骤 1：声明资源

在需要使用 BindingProxy 的容器（如 DataGrid）的 Resources 中，添加 BindingProxy 实例，并将 Data 绑定到当前的 {Binding}（即该容器的 DataContext）：

<DataGrid ItemsSource="{Binding DataLists}">
    <DataGrid.Resources>
        <local:BindingProxy x:Key="proxy" Data="{Binding}" />
    </DataGrid.Resources>
    <!-- ... -->
</DataGrid>

步骤 2：在非视觉树元素中引用

在 DataGridTextColumn 等不在视觉树中的元素中，通过 Source={StaticResource proxy} 来绑定 Data 属性的子属性：

<DataGrid.Columns>
    <DataGridTextColumn
        Binding="{Binding Salary}"
        Header="Salary"
        Visibility="{Binding Data.ColumnVisibility, Source={StaticResource proxy}}" />
</DataGrid.Columns>

绑定路径中的 Data 对应 BindingProxy 的 Data 依赖属性，. 之后的 ColumnVisibility 是 ViewModel 中的属性/命令名。

完整示例

定义资源并绑定 DataContext

<DataGrid ItemsSource="{Binding DataLists}">
    <DataGrid.Resources>
        <local:BindingProxy x:Key="proxy" Data="{Binding}" />
    </DataGrid.Resources>
    <DataGrid.Columns>
        <!-- 普通的绑定，DataGridTextColumn 在单元格内部能获取到行的 DataContext -->
        <DataGridTextColumn Binding="{Binding Name}" Header="Name" />

        <!-- 需要访问外部 DataContext（如 Window 级别的 ViewModel）时使用 BindingProxy -->
        <DataGridTextColumn
            Binding="{Binding Salary}"
            Header="Salary"
            Visibility="{Binding Data.ColumnVisibility, Source={StaticResource proxy}}" />
    </DataGrid.Columns>
</DataGrid>

C# ViewModel 中的对应属性

public partial class MainWindowViewModel : ObservableObject
{
    [ObservableProperty]
    private Visibility columnVisibility = Visibility.Visible;

    // 通过命令切换列的显隐
    [RelayCommand]
    private void Hiden()
    {
        ColumnVisibility = ColumnVisibility == Visibility.Visible
            ? Visibility.Collapsed
            : Visibility.Visible;
    }
}

---

五、不使用 BindingProxy 的替代方案

方案	说明	缺点
x:Reference	通过 {Binding Path=DataContext.ColumnVisibility, Source={x:Reference SomeElement}}	x:Reference 在某些 WPF 版本中有限制，且 DataGridTextColumn 中可能无法正常工作
代码隐藏（Code-behind）	在构造函数或 Loaded 事件中手动赋值	破坏 MVVM 模式，维护成本高
附加属性（Attached Property）	自定义附加属性传递 DataContext	实现复杂，不如 BindingProxy 简洁
BindingProxy (Freezable)	当前方案	简单、MVVM 友好、通用性强

---

六、注意事项

1. 资源作用域：BindingProxy 应定义在尽可能小的作用域内（如 DataGrid.Resources），避免命名冲突。

2. Data="{Binding}" 的含义：这里绑定的是当前容器（如 DataGrid）的 DataContext，而非数据行中的项。

3. 性能：Freezable 对象在使用前建议根据情况调用 Freeze() 以提升性能，但注意冻结后无法再修改属性值。

4. TwoWay 绑定：Data 属性支持 Mode=TwoWay，可实现从非视觉树元素反向更新 ViewModel。

5. 名称空间：别忘了在 XAML 中导入 BindingProxy 所在的 CLR 命名空间：

   xmlns:local="clr-namespace:WpfApp1"
   

---

七、总结

BindingProxy + Freezable 是 WPF MVVM 开发中解决非视觉树元素无法继承 DataContext 问题的经典方案。它利用 Freezable 可以穿透视觉树继承 DataContext 的特性，将外层的 DataContext "注入" 到 DataGridTextColumn 等控件中，使得在 MVVM 模式下也能灵活控制列的绑定属性（如 Visibility、IsReadOnly 等），保持 View 与 ViewModel 的清晰分离。

文档生成自deepseek