将枚举值绑定到Route属性时遇到的XAML绑定错误问题

问题背景 #

我定义了一个枚举类型：

internal enum Routes
{
   PageOne,
   PageTwo,
}

在AppShell中，原本通过硬编码Route值的方式可以正常从MainPage导航到PageOne：

<ShellContent
    Title="Home"
    ContentTemplate="{DataTemplate local:MainPage}" />

<TabBar>
    <Tab>
        <ShellContent
            Title="PageOne"
            Route="PageOne"
            ContentTemplate="{DataTemplate local:PageOne}" />
    </Tab>
</TabBar>

但尝试用绑定枚举值的方式设置Route时，编译器报错：

<TabBar>
    <Tab>
        <ShellContent
            Title="PageOne"
            Route="{Binding Source={x:Static local:Routes.PageOne}}"
            ContentTemplate="{DataTemplate local:PageOne}" />
    </Tab>
</TabBar>

错误信息：

XamlC error XFC0009: No property, BindableProperty, or event found for "Route", or mismatching type between value and property.

奇怪的是，同样是string类型的Title属性，却能正常绑定枚举值：

<ShellContent
    Title="{Binding Source={x:Static local:Routes.PageOne}}"
    Route="PageOne" />

我还尝试过将Route绑定到自身的Title属性，也未成功：

<ShellContent
    Title="PageOne"
    Route="{Binding Source={RelativeSource Mode=Self}, Path=Title}"
    ContentTemplate="{DataTemplate local:PageOne}" />

原因分析 #

问题核心在于ShellContent的Route属性不是可绑定属性（BindableProperty），而Title属性是：

• Title属性属于BindableProperty类型，XAML绑定系统可以自动处理类型转换（比如把枚举值转为字符串）；
• Route属性只是普通CLR属性，不支持绑定语法，哪怕绑定的值能转成string，XAML编译器也会报错，因为找不到对应的BindableProperty。
  另外，Route属性在Shell初始化阶段就会被解析用于路由注册，设计上就是静态配置的，不支持动态绑定更新。

解决办法 #

方法1：自定义标记扩展转换枚举为字符串 #

写一个简单的标记扩展，直接在XAML中将枚举值转为字符串：

using Microsoft.Maui.Controls.Xaml;
using System;

[ContentProperty(nameof(EnumValue))]
public class EnumToStringExtension : IMarkupExtension
{
    public Enum EnumValue { get; set; }

    public object ProvideValue(IServiceProvider serviceProvider)
    {
        return EnumValue?.ToString();
    }
}

在XAML中引用该扩展（先添加对应命名空间）：

<Shell xmlns:extensions="clr-namespace:YourApp.Extensions">
    <TabBar>
        <Tab>
            <ShellContent
                Title="PageOne"
                Route="{extensions:EnumToString EnumValue={x:Static local:Routes.PageOne}}"
                ContentTemplate="{DataTemplate local:PageOne}" />
        </Tab>
    </TabBar>
</Shell>

方法2：代码后台设置Route值 #

在AppShell的后台代码中，找到目标ShellContent并手动设置Route：

public partial class AppShell : Shell
{
    public AppShell()
    {
        InitializeComponent();
        // 给ShellContent设置x:Name后直接赋值
        PageOneShellContent.Route = Routes.PageOne.ToString();
    }
}

对应的XAML：

<TabBar>
    <Tab>
        <ShellContent
            x:Name="PageOneShellContent"
            Title="PageOne"
            ContentTemplate="{DataTemplate local:PageOne}" />
    </Tab>
</TabBar>

方法3：用静态资源定义路由字符串 #

在Shell资源中预先定义枚举对应的字符串，再引用：

<Shell.Resources>
    <x:String x:Key="PageOneRoute">{x:Static local:Routes.PageOne}</x:String>
</Shell.Resources>

<TabBar>
    <Tab>
        <ShellContent
            Title="PageOne"
            Route="{StaticResource PageOneRoute}"
            ContentTemplate="{DataTemplate local:PageOne}" />
    </Tab>
</TabBar>

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