Xamarin Shell MenuItem命令参数无法正常获取的导航问题

问题分析 #

• 直接使用GoToAsync($"{nameof(ListsPage)}?{nameof(ListsViewModel.Group)}={MyQuery}")：参数能正常传递，但页面会被加入导航栈成为二级页面，汉堡图标会被返回箭头替代。
• 使用根路由GoToAsync($"//{nameof(ListsPage)}?{nameof(ListsViewModel.Group)}={MyQuery}")：页面保持根页面状态（汉堡图标保留），但如果页面已在栈顶，Shell不会重新创建页面实例，导致新的查询参数无法被接收，只有切换到其他页面后再返回，才会创建新实例并接收参数，但后续参数更新依然无效。

解决方法 #

方法1：让ViewModel实现IQueryAttributable接口（推荐）

通过实现该接口，每次导航到页面时，无论页面实例是否存在，都会触发ApplyQueryAttributes方法来更新参数。

在ListsViewModel中添加以下代码：

public class ListsViewModel : IQueryAttributable
{
    public string Group { get; set; }

    // 每次导航时都会调用此方法更新参数
    public void ApplyQueryAttributes(IDictionary<string, object> query)
    {
        if (query.TryGetValue(nameof(Group), out var groupValue))
        {
            Group = groupValue as string;
            // 执行参数变更后的业务逻辑，比如刷新数据
            RefreshDataByGroup(Group);
        }
    }

    private void RefreshDataByGroup(string group)
    {
        // 根据Group参数加载对应数据
    }
}

导航逻辑保持根路由方式不变：

await Shell.Current.GoToAsync($"//{nameof(ListsPage)}?{nameof(ListsViewModel.Group)}={MyQuery}");

方法2：导航前移除现有页面实例

在导航前检查当前页面是否为ListsPage，如果是则先弹出该页面，再重新导航到根页面传递新参数。

修改AppShell中的OnMenuItemClicked方法：

public async void OnMenuItemClicked(string MyQuery)
{
    if (Shell.Current.CurrentPage is ListsPage)
    {
        // 弹出当前ListsPage页面
        await Shell.Current.GoToAsync("..");
    }
    // 导航到根页面并传递新参数
    await Shell.Current.GoToAsync($"//{nameof(ListsPage)}?{nameof(ListsViewModel.Group)}={MyQuery}");
    Shell.Current.FlyoutIsPresented = false;
}

原理说明 #

Shell导航默认会复用已存在的页面实例，所以直接使用根路由导航到已在栈顶的页面时，不会触发页面的初始化逻辑（如构造函数、OnNavigatedTo），导致新参数无法被接收。通过IQueryAttributable接口可以监听参数变化，或通过移除现有实例强制创建新页面，从而实现参数的更新。

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