.NET MAUI如何从TabBar/ShellContent传递值至目标页面

针对ShellTab中ShellContent无法通过常规导航QueryParameter传递参数的问题，以下是几种直接可行的实现方式：

方法1：直接在XAML中为页面绑定参数 #

利用Shell的BindingContext或直接指定页面属性，在ShellContent初始化页面时传递参数。

示例代码： #

假设Shell的BindingContext中包含需要传递的TargetConditionId和TargetConditionName属性，修改ShellContent的XAML：

<!-- 先给Shell设置x:Name="MyShell" -->
<Shell x:Name="MyShell" ...>
    <TabBar>
        <ShellContent
            Title="Staying at Home"
            Icon="house_user_solid.png"
            ContentTemplate="{DataTemplate views:PatientEdSelectionPage}">
            <views:PatientEdSelectionPage 
                ConditionId="{Binding Source={x:Reference MyShell}, Path=BindingContext.TargetConditionId}"
                ConditionName="{Binding Source={x:Reference MyShell}, Path=BindingContext.TargetConditionName}" />
        </ShellContent>
    </TabBar>
</Shell>

页面接收参数： #

在PatientEdSelectionPage的后台代码或ViewModel中，直接使用绑定的属性值：

// 页面后台代码
public partial class PatientEdSelectionPage : ContentPage
{
    public PatientEdSelectionPage()
    {
        InitializeComponent();
        // 若参数绑定到页面属性，可在此传递给ViewModel
        if (BindingContext is PatientEdViewModel vm)
        {
            vm.ConditionId = this.ConditionId;
            vm.ConditionName = this.ConditionName;
        }
    }

    public Guid ConditionId { get; set; }
    public string ConditionName { get; set; }
}

方法2：使用共享服务传递参数 #

通过依赖注入注册一个单例的参数共享服务，在Shell中设置参数后，在目标页面的ViewModel中直接获取。

步骤1：创建共享参数服务 #

public class NavigationParamService
{
    // 定义需要传递的参数属性
    public Guid TargetConditionId { get; set; }
    public string TargetConditionName { get; set; }
}

步骤2：注册单例服务 #

在App.xaml.cs的DI容器中注册：

builder.Services.AddSingleton<NavigationParamService>();

步骤3：Shell中设置参数 #

在Shell的初始化或事件中设置参数：

var paramService = App.Current.Services.GetService<NavigationParamService>();
paramService.TargetConditionId = Guid.Parse("xxx-xxx-xxx");
paramService.TargetConditionName = "高血压";

步骤4：ViewModel中获取参数 #

修改PatientEdViewModel的构造函数，注入服务并读取参数：

public PatientEdViewModel(
    PatientEdService patientEdService,
    ConditionService conditionService,
    NavigationParamService paramService)
{
    _patientEdService = patientEdService;
    _conditionService = conditionService;

    // 读取共享参数
    ConditionId = paramService.TargetConditionId;
    ConditionName = paramService.TargetConditionName;
    Title = "Patient Education Titles";
}

方法3：利用Shell路由与QueryProperty #

为ShellContent注册路由，通过QueryParameters传递参数，并在ViewModel中用[QueryProperty]接收。

步骤1：注册路由 #

在AppShell的构造函数中注册页面路由：

public AppShell()
{
    InitializeComponent();
    Routing.RegisterRoute(nameof(PatientEdSelectionPage), typeof(PatientEdSelectionPage));
}

步骤2：修改ShellContent配置 #

<ShellContent
    Title="Staying at Home"
    Icon="house_user_solid.png"
    Route="PatientEdSelectionPage">
    <ShellContent.QueryParameters>
        <x:String x:Key="ConditionId">xxx-xxx-xxx</x:String>
        <x:String x:Key="ConditionName">高血压</x:String>
    </ShellContent.QueryParameters>
</ShellContent>

步骤3：ViewModel中接收参数 #

在PatientEdViewModel上添加[QueryProperty]属性，自动绑定参数：

[QueryProperty(nameof(ConditionId), "ConditionId")]
[QueryProperty(nameof(ConditionName), "ConditionName")]
public partial class PatientEdViewModel : BaseViewModel
{
    // 处理字符串转Guid的逻辑
    private Guid _conditionId;
    public Guid ConditionId
    {
        get => _conditionId;
        set
        {
            if (Guid.TryParse(value.ToString(), out var parsedId))
                _conditionId = parsedId;
            OnPropertyChanged();
        }
    }

    public string ConditionName { get; set; }

    // ...其他原有代码
}

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