.NET MAUI中QueryParameter在ViewModel构造函数为null如何访问

根本原因 #

你在ViewModel构造函数中取不到OpenJob参数是执行顺序导致的必然结果：

• Shell导航触发后，会先通过依赖注入容器创建目标页面、对应ViewModel的实例，这个阶段就会执行ViewModel的构造函数，此时路由参数还没有被解析和赋值，所以openJob必然是null
• 等页面和ViewModel实例创建完成后，Shell才会解析导航传递的参数字典，给标记了[QueryProperty]的属性赋值，同时触发属性变更通知——这也是为什么XAML中绑定能正常显示值：XAML的绑定机制会监听属性变更事件，等参数赋值完成后自动更新UI，不需要在构造函数阶段拿到值。

推荐实现方式 #

你可以选以下任意一种方式实现参数获取和派生逻辑，优先推荐第一种，完全符合MVVM模式，不需要在页面后置代码写额外逻辑：

方式1：利用ObservableProperty的源生成回调 #

你用了MVVM Community Toolkit的[ObservableProperty]特性，源生成器会自动为属性生成值变更的partial回调方法，参数赋值完成后会自动触发这个方法，你直接在方法里写派生逻辑即可：

[QueryProperty("OpenJob", "OpenJob")]
public partial class NoteAvailabilityViewModel : BaseViewModel {
    
    [ObservableProperty]
    OpenJob openJob;

    // 建议绑定用的集合也标记ObservableProperty，自动实现属性变更通知
    [ObservableProperty]
    List<String> jobDates;

    public NoteAvailabilityViewModel(JobsService jobsService) {
        // 构造函数中只写不依赖导航参数的初始化逻辑
    }

    // OpenJob赋值完成后源生成器会自动调用这个方法
    partial void OnOpenJobChanged(OpenJob value)
    {
        if (value == null) return;
        
        // 在这里写所有依赖OpenJob的派生逻辑
        Debug.WriteLine($"已获取到传递的OpenJob参数");
        JobDates = value.JobDateList.Select(d => d.ToString("yyyy-MM-dd")).ToList();
    }
}

方式2：在页面OnNavigatedTo生命周期中触发ViewModel初始化 #

你已经写了页面的OnNavigatedTo重写，这个生命周期方法触发时，QueryProperty的赋值已经全部完成，直接在这里调用ViewModel的初始化方法即可：

1. 先在ViewModel中添加初始化逻辑方法：

[QueryProperty("OpenJob", "OpenJob")]
public partial class NoteAvailabilityViewModel : BaseViewModel {
    
    [ObservableProperty]
    OpenJob openJob;

    [ObservableProperty]
    List<String> jobDates;

    public NoteAvailabilityViewModel(JobsService jobsService) { }

    public void LoadJobData()
    {
        if(OpenJob == null) return;
        // 编写派生逻辑
        JobDates = new List<string>();
    }
}

2. 修改页面后置代码，在导航完成时调用初始化方法：

public partial class NoteAvailabilityPage : ContentPage {
    private readonly NoteAvailabilityViewModel _vm;
    public NoteAvailabilityPage(NoteAvailabilityViewModel viewModel) {
        InitializeComponent();
        BindingContext = viewModel;
        _vm = viewModel;
    }

    protected override void OnNavigatedTo(NavigatedToEventArgs args) {
        base.OnNavigatedTo(args);
        // 此时QueryProperty参数已完成赋值
        _vm.LoadJobData();
    }
}

注意事项 #

• 所有依赖路由传参的逻辑不要写在ViewModel构造函数中，这个阶段参数尚未注入
• 绑定到XAML的属性尽量都用[ObservableProperty]标记，不要用普通公共字段/属性，否则UI无法收到属性变更通知，会出现数据不更新的问题

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