WinUI Gallery中Frame.Navigate使用自定义参数的疑问及替代实现咨询

为什么自定义的NavigationRootPageArgs能兼容Navigate方法？ #

官方文档对Navigate方法的parameter参数的限制，核心是针对需要使用GetNavigationState序列化导航状态的场景——此时参数必须是基本类型（字符串、字符、数值、GUID）才能支持序列化。但这并非框架的强制运行限制：

框架本身的Navigate方法参数类型是object，理论上可以传递任何.NET对象。WinUI Gallery的这个实现能正常工作的原因是：

• 该场景不需要通过GetNavigationState保存或恢复导航状态，因此无需遵守序列化的类型要求。
• 目标页面在接收参数时，可直接将object类型的参数强转为NavigationRootPageArgs，从而获取其中的页面实例和业务参数。

简言之，文档的要求是导航状态序列化场景的约束，而非所有导航场景的强制规则。只要不需要序列化导航状态，传递自定义对象完全符合框架运行逻辑。

该场景的其他可行实现方案 #

• 使用可序列化的基本类型参数：将复杂数据序列化为JSON字符串（或其他可序列化格式）作为参数传递，目标页面再反序列化为对应类型。这种方案支持GetNavigationState，适合需要保存导航状态的场景。

  // 导航端
  var paramJson = JsonSerializer.Serialize(yourComplexData);
  rootFrame.Navigate(targetPageType, paramJson);
  
  // 目标页面端
  protected override void OnNavigatedTo(NavigationEventArgs e)
  {
      var param = JsonSerializer.Deserialize<YourDataType>(e.Parameter as string);
  }
  

• 使用静态状态容器：定义静态类存储导航数据，导航前将数据存入静态属性，目标页面直接读取。注意在页面生命周期结束后及时清理数据，避免内存泄漏。

  // 静态容器类
  public static class NavigationStateContainer
  {
      public static object CurrentParam { get; set; }
  }
  
  // 导航端
  NavigationStateContainer.CurrentParam = yourData;
  rootFrame.Navigate(targetPageType);
  
  // 目标页面端
  protected override void OnNavigatedTo(NavigationEventArgs e)
  {
      var param = NavigationStateContainer.CurrentParam;
      NavigationStateContainer.CurrentParam = null; // 清理数据
  }
  

• 依赖注入（DI）：若应用使用DI框架，可将需要传递的服务或数据注册为瞬时/作用域服务，目标页面通过构造函数注入获取。这种方案解耦性强，适合复杂应用架构。

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