从Xamarin Forms 3.x Prism迁移至Forms 4 Shell导航：复杂参数传递咨询

嘿，这个问题我太有发言权了——我之前刚把一个用Prism的XF3.x项目迁到带Shell的XF4，刚好踩过参数传递的坑！先给你明确结论：Xamarin.Forms Shell原生并不直接支持传递非字符串类型的复杂参数，因为它的导航体系基于URI，默认只能传递字符串。不过不用慌，有几种很实用的方案可以解决，分情况给你说：

1. 结合Prism的现有能力（最适合你的迁移场景） #

既然你之前用的是Prism，那一定要试试Prism 7.2及以上版本对Shell的支持！它完美兼容Shell导航，还保留了Prism原本的参数传递逻辑——你不需要做任何复杂的序列化，直接用Prism的NavigationParameters传递复杂对象就行：

导航发起方代码： #

// 注入Prism的INavigationService
private readonly INavigationService _navigationService;

public async Task NavigateToTargetPage()
{
    var complexModel = new MyComplexModel 
    { 
        Id = 123, 
        Details = new List<string> { "Item1", "Item2" } 
    };
    var parameters = new NavigationParameters();
    parameters.Add("ComplexData", complexModel);
    
    // 直接用Prism的导航方法指向Shell中的页面路由
    await _navigationService.NavigateAsync("//TargetPage", parameters);
}

目标页面ViewModel接收参数： #

实现Prism的INavigationAware接口，在OnNavigatedTo方法里直接获取：

public class TargetPageViewModel : INavigationAware
{
    public void OnNavigatedTo(INavigationParameters parameters)
    {
        if (parameters.TryGetValue<MyComplexModel>("ComplexData", out var complexData))
        {
            // 这里直接使用你的复杂对象即可
            Console.WriteLine($"Received model with Id: {complexData.Id}");
        }
    }

    public void OnNavigatedFrom(INavigationParameters parameters) { }
    public void OnNavigatingTo(INavigationParameters parameters) { }
}

这种方案几乎不用改你之前的Prism代码习惯，迁移成本极低，我个人最推荐这个！

2. 纯原生Shell的解决方案（不依赖Prism） #

如果不想依赖Prism，纯用原生Shell的话，有两种常用方式：

方式一：序列化复杂对象为字符串传递 #

把复杂对象序列化成JSON字符串（比如用Newtonsoft.Json或System.Text.Json），作为URI参数传递，目标页面再反序列化回来：

导航发起方：

using Newtonsoft.Json;

public async Task NavigateWithSerializedParam()
{
    var complexModel = new MyComplexModel { Id = 123, Name = "Test" };
    var jsonString = JsonConvert.SerializeObject(complexModel);
    // 注意要对URI进行转义，避免特殊字符问题
    var encodedJson = Uri.EscapeDataString(jsonString);
    
    await Shell.Current.GoToAsync($"//TargetPage?complexParam={encodedJson}");
}

目标页面ViewModel接收：

用Shell的[QueryProperty]特性绑定参数，然后反序列化：

using Newtonsoft.Json;

public class TargetPageViewModel : BaseViewModel
{
    private MyComplexModel _complexData;
    public MyComplexModel ComplexData
    {
        get => _complexData;
        set => SetProperty(ref _complexData, value);
    }

    // 绑定URI中的参数名
    [QueryProperty(nameof(EncodedParam), "complexParam")]
    public string EncodedParam { get; set; }

    protected override void OnPropertyChanged(string propertyName = null)
    {
        base.OnPropertyChanged(propertyName);
        if (propertyName == nameof(EncodedParam) && !string.IsNullOrEmpty(EncodedParam))
        {
            var decodedJson = Uri.UnescapeDataString(EncodedParam);
            ComplexData = JsonConvert.DeserializeObject<MyComplexModel>(decodedJson);
        }
    }
}

方式二：利用全局状态或绑定上下文传递 #

如果你的复杂对象不需要持久化，也可以临时存在App级别的静态属性、全局字典，或者直接设置目标页面的BindingContext：

// 导航发起方
var complexModel = new MyComplexModel { Id = 123 };
var targetPage = new TargetPage();
targetPage.BindingContext = complexModel;

await Shell.Current.Navigation.PushAsync(targetPage);

不过这种方式要注意内存泄漏问题，页面销毁时记得及时清理绑定的对象。

总结 #

• 如果你继续用Prism，优先选Prism+Shell的方案，完全兼容旧代码，不用额外折腾；
• 纯原生Shell的话，序列化方案最通用，全局状态方案适合简单场景。

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