.NET MAUI MVVM页面打开时加载CollectionView数据的最佳实现方案

问题原因说明 #

相关报错和功能不生效的核心原因有3个：

• [ICommand]是CommunityToolkit.Mvvm的源生成特性，会为标注的异步方法生成一个ICommand类型的公共属性，命名规则为「方法名去掉Async后缀+Command」，即代码中的GetFieldAssignedWbsListCommand是属性而非方法，不能直接加()按方法方式调用。
• 页面构造函数不支持async/await异步调用，构造函数执行时页面还未完成渲染，在此处强行调用异步逻辑要么触发编译错误，要么存在死锁、异常无法捕获的风险。
• 移除[ICommand]特性后，源生成器不会再生成对应Command属性，此时既没有将原数据加载方法改为公共可访问级别，也没有绑定正确的页面生命周期触发时机，自然无法自动执行。

自动加载逻辑的职责划分 #

核心数据加载逻辑（接口请求、集合处理、错误捕获、加载状态控制）必须放在ViewModel中实现，Code Behind（代码后置）仅负责识别页面加载完成的时机，触发ViewModel中的加载逻辑即可。

禁止将数据请求、集合操作类业务逻辑写到Code Behind中，否则会破坏MVVM分层规范，后续单元测试、逻辑复用都会受影响。

具体实现步骤 #

1. 调整ViewModel代码 #

保留现有[ICommand]特性和核心加载逻辑，给GetFieldAssignedWbsListAsync方法加public修饰符（默认不加修饰符为private，外部类无法访问）即可。代码中错误提示文案Undable to get monkeys是Workshop猴子示例的遗留内容，可自行替换为对应业务提示，参考代码如下：

public partial class FieldAssignedWbsViewModel : BaseViewModel
{
    FieldAssignedWbsService fieldAssignedWbsService;
    public ObservableCollection<FieldAssignedWbs> WbsList { get; set; } = new();

    public FieldAssignedWbsViewModel(FieldAssignedWbsService fieldAssignedWbsService)
    {
        Title = "Wbs Assigned";
        this.fieldAssignedWbsService = fieldAssignedWbsService;
    }

    [ICommand]
    public async Task GetFieldAssignedWbsListAsync()
    {
        if (IsBusy)
            return;
        try
        {
            IsBusy = true;
            var wbsList = await fieldAssignedWbsService.GetFieldAssignedWbsList();
            if (WbsList.Count != 0)
                WbsList.Clear();
            foreach (var wbs in wbsList)
                WbsList.Add(wbs);
        }
        catch (Exception ex)
        {
            Debug.WriteLine(ex);
            await Shell.Current.DisplayAlert("加载错误!",
                $"获取已分配WBS数据失败：{ex.Message}", "确定");
        }
        finally
        {
            IsBusy = false;
        }
    }
}

2. 修正页面后置代码 #

不要在构造函数中调用加载逻辑，重写页面的OnAppearing生命周期方法，在页面每次显示时触发加载（可根据自身需求加判断，比如数据已经加载过就不重复请求），参考代码如下：

public partial class FieldAssignedWbsPage : ContentPage
{
    private readonly FieldAssignedWbsViewModel _viewModel;
    public FieldAssignedWbsPage(FieldAssignedWbsViewModel viewModel)
    {
        InitializeComponent();
        BindingContext = viewModel;
        _viewModel = viewModel;
    }

    protected override async void OnAppearing()
    {
        base.OnAppearing();
        // 可选判断：如果列表已经有数据就不重复加载，不需要可直接删除
        if (_viewModel.WbsList.Count > 0)
            return;

        // 调用方式1：直接调用公开的异步方法（推荐，逻辑更清晰）
        await _viewModel.GetFieldAssignedWbsListAsync();

        // 调用方式2：通过生成的Command属性执行，需要调用ICommand的Execute方法
        // _viewModel.GetFieldAssignedWbsListCommand.Execute(null);
    }
}

3. XAML部分调整 #

现有CollectionView绑定逻辑可正常工作，直接删掉之前绑定加载Command的触发按钮即可，页面加载完成后会自动拉取数据填充列表。

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