C# Avalonia怎么使用依赖属性 Avalonia AvaloniaProperty教程

AvaloniaProperty 是 Avalonia 中实现数据绑定、样式、动画等的核心机制，为不可变属性描述符，值由 AvaloniaObject 稀疏存储管理；需用 AvaloniaProperty.Register 静态注册，配合 GetValue/SetValue 使用，并支持 XAML 绑定、变更回调与继承等特性。

在 Avalonia 中，依赖属性（AvaloniaProperty）是实现数据绑定、样式、模板、动画和属性继承等核心功能的基础机制。它不同于 WPF 的 DependencyProperty，但设计理念相似，使用方式更轻量、更函数式。

什么是 AvaloniaProperty？

AvaloniaProperty 是一个不可变的类型，用于注册和标识 UI 元素上的可绑定、可动画、可继承的属性。它本身不存储值，而是作为“属性描述符”存在，真正的值由 AvaloniaObject（如 Control、Window）内部的稀疏存储系统管理。

所有 Avalonia 控件都继承自 AvaloniaObject，因此天然支持依赖属性。

如何定义和注册一个依赖属性？

使用静态只读字段 + AvaloniaProperty.Register 方法注册。推荐在类内部声明，并用 public static readonly 修饰。

• 语法简洁：只需指定属性名、所属类型、默认值（可选）、元数据（如是否继承、是否可动画）
• 泛型强类型：编译期检查类型安全，无需装箱/拆箱

示例：为自定义控件 MyButton 添加一个 CornerRadius 属性：

public class MyButton : Button
{
    public static readonly AvaloniaProperty<CornerRadius> CornerRadiusProperty =
        AvaloniaProperty.Register<MyButton, CornerRadius>(nameof(CornerRadius), defaultValue: new CornerRadius(4));
<pre class="brush:php;toolbar:false;">public CornerRadius CornerRadius
{
    get => GetValue(CornerRadiusProperty);
    set => SetValue(CornerRadiusProperty, value);
}