当前位置：首页 > news >正文

AvaloniaProperty

news 2026/5/11 12:14:02

Avalonia 并不是单纯地复刻了 WPF 的属性系统，而是对其进行了“扩容”。

在 WPF 中，几乎所有高级功能（绑定、动画、样式）都依赖 DependencyProperty。

而在 Avalonia 中，为了性能和灵活性，它把属性拆分成了两类：StyledProperty（更像 WPF）和 DirectProperty（更轻量）。

1. 核心成员关系图

为了方便理解，你可以把它们的关系看作：

AvaloniaProperty: “属性”的总称（抽象基类）。
StyledProperty: 功能全、支持样式（Style）和资源（Resource），但开销略大。
DirectProperty: 速度快、开销小，主要用于简单的属性，不支持样式覆盖。

2. StyledProperty：WPF 开发者最熟悉的“老朋友”

这是 WPF DependencyProperty 的直接替代品。它支持 Avalonia 最强大的特性：样式系统。

特点：支持从 CSS 类似的样式表中继承值，支持优先级排序（如：本地值 > 样式值 > 默认值）。
适用场景：绝大多数 UI 控件的自定义属性（如 Background, FontSize）。

public class MyControl : Control
{// 1. 定义：使用 AvaloniaProperty.Register 注册// 类似于 WPF 的 DependencyProperty.Registerpublic static readonly StyledProperty<string> MyTextProperty =AvaloniaProperty.Register<MyControl, string>(name: "MyText",            // 属性名defaultValue: "Hello");    // 默认值// 2. 包装：CLR 属性包装器public string MyText{get => GetValue(MyTextProperty);set SetValue(MyTextProperty, value);}
}

3. DirectProperty：为性能而生的“新武器”

这是 Avalonia 的特色。它不通过 Avalonia 的内部字典存储值，而是直接使用你类中的私有字段。

特点：
快：读写速度接近普通 C# 属性。
省：内存占用极低。
局限：不支持样式（Styles）覆盖。你不能在 .axaml 的 <Style> 里改变它的值。
适用场景：只需要数据绑定、只需要只读属性、或者对性能要求极高的列表项属性。

public class MyControl : Control
{// 1. 定义私有字段存储数据private string _fileName = "untitled.txt";// 2. 定义：使用 AvaloniaProperty.RegisterDirect 注册public static readonly DirectProperty<MyControl, string> FileNameProperty =AvaloniaProperty.RegisterDirect<MyControl, string>(nameof(FileName),      // 属性名o => o.FileName,       // Getter：告诉框架怎么读字段(o, v) => o.FileName = v // Setter：告诉框架怎么写字段);// 3. 包装：直接操作私有字段public string FileName{get => _fileName;// 注意：设置值时需要调用 SetAndRaise 触发通知，以便绑定能更新set => SetAndRaise(FileNameProperty, ref _fileName, value);}
}

4. 总结对比

特性	StyledProperty (类似 WPF)	DirectProperty (Avalonia 特色)
存储方式	框架内部维护（字典存储）	类成员字段（手动定义字段）
查询速度	较慢（涉及优先级计算）	极快（直接访问字段）
样式支持	支持（可在 Style 中写 Setter）	不支持
默认值	在注册时统一定义	在字段初始化时定义
内存开销	稍高	极低