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 CornerRadiusProperty = AvaloniaProperty.Register(nameof(CornerRadius), defaultValue: new CornerRadius(4));public CornerRadius CornerRadius{ get => GetValue(CornerRadiusProperty); set => SetValue(CornerRadiusProperty, value);}
}
注意：GetValue/SetValue 是 AvaloniaObject 提供的基方法，必须成对使用；属性包装器（即 CLR 属性）不是必需的，但强烈建议提供，方便 C# 代码调用和 XAML 绑定。
如何在 XAML 和绑定中使用？
注册后即可像内置属性一样使用：
XAML 中直接设置：支持绑定：支持样式触发器和模板绑定
若需响应属性变更，可在注册时传入 new AvaloniaPropertyMetadata(default, onChanged)，其中 onChanged 是一个 Action 委托，接收对象实例、旧值和新值。
public static readonly AvaloniaProperty TitleProperty = AvaloniaProperty.Register( nameof(Title), defaultValue: "Default", metadata: new AvaloniaPropertyMetadata( default, (o, _, newValue) => ((MyButton)o).OnTitleChanged(newValue)));private void OnTitleChanged(string newValue){// 响应逻辑，例如更新内部 TextBlock}
高级技巧与注意事项
附加属性：用 AvaloniaProperty.RegisterAttached 定义，适用于扩展其他控件行为（如 Grid.Row），需提供 GetXXX 和 SetXXX 静态方法继承属性：通过 AvaloniaPropertyMetadata.Inherits = true 启用，子元素自动继承父级该属性值（如 FontSize）验证回调：注册时可传入 validate 函数（Func），在设值前校验合法性避免内存泄漏：不要在 onChanged 中捕获外部引用或注册未释放的事件
不复杂但容易忽略：所有依赖属性必须在静态构造函数或类加载时完成注册，不能延迟初始化；且一个属性只能注册一次，重复注册会抛异常。
以上就是C# Avalonia怎么使用依赖属性 Avalonia AvaloniaProperty教程的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1443260.html
微信扫一扫 
支付宝扫一扫 
