MAUI中如何通过QueryProperty传递并解析枚举类型？

定义了如下枚举类型：

public enum MediaTypes
{
    Book = 0,
    Video = 1,
    Magazine = 2,
    Picture = 3,
    All = 99
}

希望通过QueryProperty将枚举传递到页面并获取其值，当属性类型设为int时可以正常工作：

[QueryProperty("MediaType", "MediaType")]
public int MediaType { get; set; }

但改为MediaTypes枚举类型时会抛出转换错误：

public MediaTypes MediaType { get; set; }

请问通过QueryProperty传递并解析枚举类型的正确方式是什么？

可以通过两种实用方式实现枚举类型的QueryProperty绑定：

方法一：用包装属性做类型转换 #

保留目标枚举属性，额外定义一个用于接收Query参数的int类型包装属性，在其setter中完成类型转换：

private MediaTypes _mediaType;
public MediaTypes MediaType 
{ 
    get => _mediaType; 
    set => SetProperty(ref _mediaType, value);
}

[QueryProperty("MediaTypeQuery", "MediaType")]
public int MediaTypeQuery
{
    set => MediaType = (MediaTypes)value;
}

传递参数时直接使用枚举对应的int值即可，比如导航时传?MediaType=1，包装属性会自动把int值转为MediaTypes.Video赋值给目标枚举属性。

方法二：直接用枚举属性并手动处理转换 #

如果想直接把枚举属性作为QueryProperty的目标，可以在页面导航生命周期中手动处理参数转换，同时支持int值和枚举名称字符串两种传递方式：

private MediaTypes _mediaType;

[QueryProperty("MediaType", "MediaType")]
public MediaTypes MediaType
{
    get => _mediaType;
    set => SetProperty(ref _mediaType, value);
}

protected override void OnNavigatedTo(NavigatedToEventArgs args)
{
    base.OnNavigatedTo(args);
    if (Navigation.Parameter is IDictionary<string, object> queryParams && queryParams.TryGetValue("MediaType", out var value))
    {
        // 先尝试转int值
        if (int.TryParse(value.ToString(), out int intValue))
        {
            MediaType = (MediaTypes)intValue;
        }
        // 再尝试转枚举名称字符串
        else if (Enum.TryParse<MediaTypes>(value.ToString(), out var enumValue))
        {
            MediaType = enumValue;
        }
    }
}

这种方式既支持传?MediaType=99，也支持传?MediaType=All，兼容性更强。

注意事项 #

• 传递参数时要确保值是枚举的有效int值或正确的枚举名称，避免无效值导致转换失败
• 如果使用Prism、MvvmCross这类MVVM框架，部分框架已经内置了枚举类型的QueryProperty转换支持，可直接用枚举属性无需额外处理

内容的提问来源于stack exchange，提问作者pbickford