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 + 服务查。不复杂但容易忽略细节。










