Xamarin.Forms MVVM模式下CollectionView初始加载不显示数据

MVVM架构下开发Xamarin.Forms应用时，页面首次加载过程中CollectionView无法展示API返回的数据，调试可确认ReleasedDocuments集合已经正确拿到数据、CountRelease计数正常，但UI无任何内容渲染；手动下拉触发RefreshView刷新后，数据就能正常展示。

代码存在两个核心问题，共同导致首次加载失效：

1. 首次加载未主动触发数据请求逻辑
   RefreshView绑定的LoadReleaseDocuments命令，默认只会在用户手动下拉交互时触发，页面首次进入、ViewModel初始化阶段不会自动执行该命令。注意：给IsRefreshing赋值为true仅控制刷新动画的显示，不会自动执行绑定的Command。
2. 刷新状态复位时序错误
   原ExecuteCommand方法中，IsRefreshing = false被写在了Device.BeginInvokeOnMainThread异步代码块的外部，属于同步执行逻辑：异步网络请求、数据填充的任务刚被派发到UI线程队列，这行代码就会立刻执行，在数据还没返回、集合还没填充完成时就提前把刷新状态复位，直接打乱了CollectionView的渲染时序，导致数据填充完成后UI没有触发重绘。
   而手动下拉刷新时，RefreshView控件本身会接管状态时序：等绑定Command的异步逻辑完全执行完成后，才会复位IsRefreshing状态，因此不会出现时序错乱问题，数据可以正常显示。

按以下步骤修改即可解决问题：

1. 修正ExecuteCommand的时序逻辑 #

删掉异步块外部多余的IsRefreshing = false，去掉不必要的Device.BeginInvokeOnMainThread包裹（async/await会自动在执行完成后回到UI线程，满足ObservableCollection的线程操作要求），修正后代码如下：

// 方法加async关键字，去掉多余的UI线程派发包裹
async void ExecuteCommand()
{
    bool forceRefresh = true;
    if (IsRefreshing)
        return;

    IsRefreshing = true;
    try
    {
        ReleasedDocuments.Clear();
        // 取值时加类型判断避免空引用
        if (Application.Current.Properties["Position"] is string position && position.Contains("Courier"))
        {
            var items = await DataStore.GetItemsAsync(forceRefresh, position, "tmdm");
            items = items.Where(ab => ab.TMNo != null).Where(ac => ac.TMNo.Contains("DM"));
            var sortedItems = items.OrderByDescending(c => c.OrderDate);
            CourierDMData(sortedItems);
        }
    }
    catch (Exception ex)
    {
        IsBusy = false;
        IsRefreshing = false;
        // 原有异常处理逻辑保留
    }
    finally
    {
        IsBusy = false;
        IsRefreshing = false;
    }
}

2. 主动触发首次加载 #

选择以下任意一种方式，在页面首次加载时主动执行加载命令：

• 方式一：在ViewModel构造函数末尾直接调用命令，适合页面创建后就需要加载数据的场景

public MainPageViewModel()
{ 
    // 原有集合、Command初始化逻辑保留
    ReleasedDocuments = new ObservableCollection<Release>();
    DeliveredDocuments = new ObservableCollection<Deliver>(); 
    CallNow = new Command<Deliver>(Call_Now);
    LoadDocuments = new Command(ExecuteLoadItemsCommand); 
    LoadReleaseDocuments = new Command(ExecuteCommand); 

    // 新增：构造完成后主动触发首次加载
    LoadReleaseDocuments.Execute(null);
}

• 方式二：在页面后台代码重写OnAppearing方法触发，适合需要每次页面进入刷新、或者要等页面完全渲染完成再加载的场景

// MainPage.xaml.cs
private bool _hasFirstLoad = false;
protected override void OnAppearing()
{
    base.OnAppearing();
    // 仅首次进入触发，避免每次页面返回都重复请求
    if (!_hasFirstLoad)
    {
        _hasFirstLoad = true;
        if (BindingContext is MainPageViewModel vm)
        {
            vm.LoadReleaseDocuments.Execute(null);
        }
    }
}

3. 基础配置校验 #

确认ViewModel中IsRefreshing、CountRelease等属性正确实现了INotifyPropertyChanged接口，属性值变更时能正常触发PropertyChanged事件，保证UI能收到状态变更通知。

内容的提问来源于stack exchange，提问作者team-btg