Avalonia在Style内绑定Classes属性报错非AvaloniaProperty该如何解决？

报错原因 #

Classes不是 Avalonia 注册的可绑定依赖属性（AvaloniaProperty），它是StyledElement内置的只读字符串集合实例，不支持直接通过Style的Setter整体赋值或者绑定，因此会触发对应的诊断错误。

正确实现方案 #

方案1：逐个绑定类的激活状态（官方推荐） #

Avalonia 原生支持Classes.类名的属性写法，可直接绑定ViewModel中的布尔值，动态控制对应类的添加、移除，无需额外编写代码：

<Style Selector="Button">
    <!-- 当绑定的IsPrimary为True时添加primary类，为False时移除 -->
    <Setter Property="Classes.Primary" Value="{Binding IsPrimary}" />
    <!-- 可同时绑定多个不同类的开关状态 -->
    <Setter Property="Classes.Warning" Value="{Binding IsWarning}" />
</Style>

该方案性能最优，适配绝大多数类名固定、可对应独立布尔状态的业务场景。

方案2：绑定完整类集合（适配类名动态不固定的场景） #

如果确实需要一次性绑定整个动态生成的类集合（比如ViewModel中返回IEnumerable<string>类型的类列表），可通过自定义附加属性中转实现：

1. 定义中转附加属性

using Avalonia;
using Avalonia.Styling;
using System.Collections.Generic;

namespace YourNamespace
{
    public static class ClassBindingHelper
    {
        public static readonly AvaloniaProperty<IEnumerable<string>> DynamicClassesProperty =
            AvaloniaProperty.RegisterAttached<ClassBindingHelper, StyledElement, IEnumerable<string>>("DynamicClasses");

        static ClassBindingHelper()
        {
            DynamicClassesProperty.Changed.AddClassHandler<StyledElement>(OnDynamicClassesChanged);
        }

        private static void OnDynamicClassesChanged(StyledElement element, AvaloniaPropertyChangedEventArgs args)
        {
            element.Classes.Clear();
            if (args.NewValue is IEnumerable<string> newClasses)
            {
                element.Classes.AddRange(newClasses);
            }
        }

        public static void SetDynamicClasses(StyledElement element, IEnumerable<string> value)
        {
            element.SetValue(DynamicClassesProperty, value);
        }

        public static IEnumerable<string> GetDynamicClasses(StyledElement element)
        {
            return element.GetValue<IEnumerable<string>>(DynamicClassesProperty);
        }
    }
}

2. 在XAML中绑定附加属性
   首先在XAML头部引入附加属性对应的命名空间：

xmlns:local="clr-namespace:YourNamespace;assembly=YourAssemblyName"

再修改Style的Setter绑定该附加属性即可：

<Style Selector="Button">
    <Setter Property="local:ClassBindingHelper.DynamicClasses" Value="{Binding MyClasses}" />
</Style>

内容的提问来源于stack exchange，提问作者tyr.bentsen