Avalonia中的Compiled Bindings怎么用 Avalonia编译绑定x:CompileBindings

来源：这里教程网时间：2026-02-21 17:33:48 作者：

在 Avalonia 中启用

x:CompileBindings

（编译绑定）能显著提升数据绑定性能，并在编译期捕获绑定错误，避免运行时才发现属性名写错、类型不匹配等问题。

1. 启用编译绑定需要两个前提

必须同时满足以下两点，编译绑定才真正生效：

在 XAML 根元素（如
Window
、
UserControl
）上显式设置
x:CompileBindings="True"
对应的数据上下文（
DataContext
）类型必须是已知的、非
object
的具体类型（推荐使用泛型
DataContext="{Binding}"
或在代码中明确赋值为某个类实例）

例如：

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        x:Class="MyApp.MainWindow"
        x:CompileBindings="True">
  <TextBlock Text="{Binding UserName}" />
</Window>

此时若

MainWindow.DataContext

是

ViewModel

类型，且该类有

UserName

属性，绑定就能被编译器校验；如果写成

{Binding UserNmae}

（拼错），编译会直接报错。

2. 避免编译绑定失效的常见情况

以下写法会导致编译绑定“静默退化”为运行时绑定（失去编译检查和性能优势）：

DataContext
被设为
object
或
INotifyPropertyChanged
等泛型接口（编译器无法推断具体属性） XAML 中用了
RelativeSource
、
ElementName
、
TemplateBinding
等动态查找方式（它们本质依赖运行时解析）绑定路径含索引器（如
{Binding Items[0].Name}
）或复杂转换（如
{Binding Path=Items.Count}
）——部分支持，但深度嵌套可能绕过编译检查

3. 在 ViewModel 中配合使用更可靠

推荐在视图类中显式声明

DataContext

类型（C# 侧），让 XAML 编译器更容易推导：

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        DataContext = new MainViewModel(); // 明确赋值具体类型
    }
}

或者在 XAML 中用

x:DataType

声明（Avalonia 11+ 支持）：

<UserControl xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="MyApp.MyView"
             x:CompileBindings="True"
             x:DataType="local:MyViewModel">

这样即使