Avalonia怎么在XAML中使用枚举类型 Avalonia绑定枚举教程

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

在XAML中声明并引用枚举类型

要在XAML里使用枚举，必须先引入其所在命名空间。假设你有一个枚举定义在 MyApp.Core 命名空间下：

namespace MyApp.Core
{
    public enum ConnectionState
    {
        Disconnected,
        Connecting,
        Connected,
        Failed
    }
}

那么在AXAML文件顶部添加对应 xmlns 声明：

xmlns:core="using:MyApp.Core"

之后就能在资源、绑定或属性中直接引用该枚举，例如：

<TextBlock Text="{Binding Status, Converter={StaticResource EnumToStringConverter}}" />
<RadioButton Content="已连接" IsChecked="{Binding Status, Converter={StaticResource EnumToBoolConverter}, ConverterParameter={core:ConnectionState.Connected}}" />

用ObjectDataProvider暴露枚举值列表

若需将枚举作为下拉项、单选按钮组的数据源（比如让多个 RadioButton 对应不同枚举值），推荐用 ObjectDataProvider 包装

Enum.GetValues

：

<Window.Resources>
  <ObjectDataProvider x:Key="ConnectionStates" 
                        ObjectType="{x:Type core:ConnectionState}" 
                        MethodName="GetValues">
    <ObjectDataProvider.MethodParameters>
      <x:Type TypeName="core:ConnectionState" />
    </ObjectDataProvider.MethodParameters>
  </ObjectDataProvider>
</Window.Resources>

然后绑定到 ListBox 或 ItemsControl：

<ListBox ItemsSource="{Binding Source={StaticResource ConnectionStates}}" 
         SelectedItem="{Binding CurrentState, Mode=TwoWay}" />

RadioButton 绑定枚举值的关键写法

直接绑定

IsChecked

到枚举属性时，Avalonia 不支持原生双向映射，必须借助转换器。常见错误如 “Unexpected token None” 就是因为没正确传入

ConverterParameter

或未注册命名空间。

你需要一个实现

IValueConverter

的转换器，核心逻辑是：

Convert：把枚举值比对
ConverterParameter
，相等返回
true
，否则
false
ConvertBack：当
IsChecked==true
时，返回
ConverterParameter
对应的枚举值；否则返回
Binding.DoNothing
（避免误覆盖）

XAML 中每个 RadioButton 写法示例：

<RadioButton Content="断开" 
            IsChecked="{Binding State, 
                                Converter={StaticResource EnumToBoolConverter}, 
                                ConverterParameter={core:ConnectionState.Disconnected}}" />
<RadioButton Content="连接中" 
            IsChecked="{Binding State, 
                                Converter={StaticResource EnumToBoolConverter}, 
                                ConverterParameter={core:ConnectionState.Connecting}}" />

确保 ViewModel 属性支持通知

绑定的枚举属性必须触发变更通知，否则 UI 不会响应选择变化。推荐用 ReactiveUI 的

RaiseAndSetIfChanged

或 Avalonia 自带的

ObservableObject

模式：

private ConnectionState _state = ConnectionState.Disconnected;
public ConnectionState State
{
    get => _state;
    set => this.RaiseAndSetIfChanged(ref _state, value);
}

若使用纯 Avalonia，确保继承自