MAUI怎么传递参数到新页面 MAUI导航传参步骤

MAUI中传递参数到新页面推荐使用Shell路由配合QueryProperty特性，需在目标页属性标注[QueryProperty]、AppShell注册带占位符路由、调用GoToAsync传参；非Shell项目可用构造函数或公共属性传简单参数；复杂对象应仅传ID并通过服务查询。

MAUI 里传递参数到新页面，核心是用 Shell 或 NavigationPage 的导航机制配合路由参数（Route Parameters）或查询字符串（Query Attributes），不推荐直接传对象引用。

使用 Shell 路由 + QueryProperty 传参（推荐）

这是 MAUI 官方推荐、类型安全、支持深度链接的方式。关键三步：

在目标页面（如 DetailPage.xaml.cs）上，给需要接收的属性加上 [QueryProperty] 特性，并确保属性有 public set 访问器
在 AppShell 中注册带参数占位符的路由，例如：
Routing.RegisterRoute("detail/{id}", typeof(DetailPage));
跳转时用 Shell.Current.GoToAsync("detail/123") 或带查询参数：
Shell.Current.GoToAsync("detail/123?title=Hello&category=News");

对应页面示例：

[QueryProperty(nameof(ItemId), "id")]
[QueryProperty(nameof(Title), "title")]
public partial class DetailPage : ContentPage
{
    public string ItemId { get; set; }
    public string Title { get; set; }
    // 属性被赋值后，OnAppearing 或构造函数后自动触发（注意：构造函数中还拿不到）
}

用 Navigation.PushAsync 传简单参数（适合非 Shell 项目）

如果没用 Shell，而是基于 NavigationPage，可手动在跳转前设置参数：

新建页面实例时，通过构造函数传参（最直接）：

var page = new DetailPage("123", "Hello");
await Navigation.PushAsync(page);

或定义公共属性，在 Push 前赋值：

var page = new DetailPage();
page.ItemId = "123";
page.Title = "Hello";
await Navigation.PushAsync(page);

⚠️ 注意：这种方式不支持 URI 导航和热重载调试，适合小型或原型项目。

传复杂对象？别直接传，改用服务或 ID 查找

MAUI 不支持跨页面序列化传递自定义对象（尤其含事件、BindingContext 等）。正确做法是：

只传唯一标识（如 int id 或 string key）
在目标页通过 IEnumerable 或注入的数据服务（如 IDataService）按 ID 查询真实数据
或使用 WeakReferenceMessenger 发送消息（适合解耦但非导航主流程）

接收参数后的处理时机

用 [QueryProperty] 时，属性会在页面初始化后期被自动赋值，但不是在构造函数里。建议：

在 OnAppearing() 中使用参数加载数据（最常用）
或监听属性 setter，触发刷新逻辑（需手动实现 INotifyPropertyChanged）
避免在构造函数里依赖这些参数——它们此时还是默认值

基本上就这些。关键是选对方式：Shell 项目优先走 Route + QueryProperty；简单跳转用构造函数；复杂数据靠 ID + 服务查。不复杂但容易忽略细节。

# go # app # ai # 路由 # String # 构造函数 # 字符串 # int # public # 访问器 # var # 对象 # 事件 # typeof # 跳转 # 不支持 # 到新 # 这是 # 是在 # 推荐使用 # 会在 # 自定义 # 三步 # 时用

返回目录在线咨询

上一篇：jQuery动态生成表格及右键菜单功能示例
下一篇：共享主机和独立服务器租用费用的优劣对比及适用场景分析

您的项目需求