MAUI中Prism的INavigationParameters原生替代方案是什么？

MAUI本身没有和Prism OnNavigatedTo完全一致的原生API，但可以通过内置导航参数机制结合视图模型生命周期钩子实现类似效果，无需手动传参。

核心实现思路 #

MAUI支持通过Microsoft.Maui.Controls.NavigationParameters传递导航参数，配合视图模型属性绑定或参数提取逻辑，再结合页面OnAppearing触发自定义方法，就能模拟Prism中自动获取参数的OnNavigatedTo行为。

方案1：QueryProperty特性自动绑定参数（推荐） #

这是MAUI原生推荐的参数映射方式，能自动将导航参数绑定到视图模型属性，无需手动提取。

1. 定义视图模型：

public class TargetViewModel : ObservableObject
{
    // 第一个参数是导航参数名，第二个是视图模型属性名
    [QueryProperty(nameof(ItemId), "itemId")]
    public string ItemId { get; set; }

    // 模拟OnNavigatedTo的方法，参数绑定完成后执行
    public void OnNavigatedTo()
    {
        // 直接使用已绑定的参数
        Console.WriteLine($"Received item ID: {ItemId}");
    }
}

2. 发起导航传递参数：

// 导航到TargetPage并传递itemId参数
await Navigation.PushAsync(new TargetPage(), new NavigationParameters
{
    { "itemId", "1001" }
});

3. 在页面中触发视图模型方法：

protected override void OnAppearing()
{
    base.OnAppearing();
    if (BindingContext is TargetViewModel vm)
    {
        vm.OnNavigatedTo();
    }
}

方案2：手动提取导航参数（复杂场景适用） #

如果需要处理多参数或复杂对象，可直接从页面Navigation属性中提取参数集合，传递给视图模型方法。

1. 定义视图模型：

public class TargetViewModel : ObservableObject
{
    public async Task OnNavigatedTo(NavigationParameters parameters)
    {
        if (parameters.TryGetValue("userInfo", out UserInfo user))
        {
            // 处理复杂参数
            await LoadUserProfile(user);
        }
    }
}

2. 页面中提取并传递参数：

protected override void OnAppearing()
{
    base.OnAppearing();
    if (BindingContext is TargetViewModel vm)
    {
        // 获取当前页面的导航参数
        var navParams = Navigation.NavigationStack.Last().NavigationParameter as NavigationParameters;
        vm.OnNavigatedTo(navParams ?? new NavigationParameters());
    }
}

3. 导航传递复杂参数：

await Navigation.PushAsync(new TargetPage(), new NavigationParameters
{
    { "userInfo", new UserInfo { Id = 2002, Name = "Alice" } }
});

注意事项 #

• QueryProperty仅支持字符串类型参数，传递复杂对象时建议用方案2，或先序列化对象为字符串，再在视图模型中反序列化。
• 若使用MAUI Shell导航，参数传递逻辑一致，可通过ShellNavigationState传递参数，同样支持QueryProperty绑定。

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