MAUI中CommunityToolkit ObservableCollection更新后CollectionView不刷新的优化方案

问题背景 #

使用MVVM模式、CommunityToolkit库、SQLite数据库及EntityFramework Core开发MAUI应用，遇到以下问题：编辑实体后返回列表页（CollectionView），CollectionView无法同步显示变更。

相关代码片段 #

ViewModel代码 #

public partial class TeamsViewModel : ObservableObject {
    public ObservableCollection<Team> Teams { get; set; }

    private readonly IViewTeamsUseCase _viewTeamsUseCase;
    private readonly IDeleteTeamUseCase _deleteTeamUseCase;

    public TeamsViewModel(IViewTeamsUseCase viewTeamsUseCase, IDeleteTeamUseCase deleteTeamUseCase) {
        Teams = new ObservableCollection<Team>();
        _viewTeamsUseCase = viewTeamsUseCase;
        _deleteTeamUseCase = deleteTeamUseCase;
    }

    private async void LoadTeamsMethod(string filterText) {
        await LoadTeamsAsync(filterText);
    }
    public async Task LoadTeamsAsync(string filterText = null) {
        Teams.Clear();
        var teams = await _viewTeamsUseCase.ExecuteAsync(filterText);
        if (teams != null && teams.Count > 0) {
            foreach (var team in teams) {
                this.Teams.Add(team);
            }
        }
    }
}

视图页面代码 #

public TeamsPage(TeamsViewModel teamsViewModel)
{
    InitializeComponent();
    _teamsViewModel = teamsViewModel;
    this.BindingContext = _teamsViewModel;
}
protected override async void OnAppearing() {
    base.OnAppearing();
    await _teamsViewModel.LoadTeamsAsync();
}

存在问题的仓储层Update方法 #

public async Task UpdateTeam(int teamId, Team team)
{
    var teamToUpdate = await _context.Teams.FindAsync(teamId);
    if (teamToUpdate is not null)
    {
        teamToUpdate.Name = team.Name;
        await _context.SaveChangesAsync();
    }
} 

临时可行的仓储层Update方法 #

public async Task UpdateTeam(int teamId, Team team) {
    if (teamId != team.TeamId) { return; }
    var teamToUpdate = await _context.Teams.FindAsync(teamId);
    if (teamToUpdate is not null) {
        _context.Teams.Remove(teamToUpdate);
        _context.Add(new Team { Name = team.Name });
        await _context.SaveChangesAsync();
    }
}

尝试过的Teams集合封装代码 #

public partial class TeamsViewModel : ObservableObject {
private ObservableCollection<Team> _teams;
public ObservableCollection<Team> Teams {
    get => _teams;
    set { 
        SetProperty(ref _teams, value);            
    }
}

调试发现的现象 #

执行Teams.Clear()之前，Teams中的数据已更新，但CollectionView未刷新。

疑问与需求 #

我的理解：Teams作为ObservableCollection本应被CollectionView监听，但结合EF Core使用时，ObservableCollection被实时跟踪更新，即使执行Teams.Clear()也无法让框架检测到变更，只有删除原实体再新增实体才能触发PropertyChanged事件。

请问我的理解是否正确？恳请提供更优的解决方案。

分析与优化方案 #

你的理解部分正确 #

EF Core的变更跟踪会导致内存中的实体对象被实时更新（因为_viewTeamsUseCase返回的实体是被EF上下文跟踪的），所以ObservableCollection里的实体实例已经是更新后的状态，但CollectionView没有检测到单个实体的属性变更——因为Team类没有实现INotifyPropertyChanged接口，即使实体属性值变了，也不会通知CollectionView刷新对应项。

而删除再新增的方式之所以有效，是因为ObservableCollection的Remove和Add操作会触发CollectionChanged事件，迫使CollectionView重新渲染整个列表。

更优解决方案 #

1. 让Team实体实现INotifyPropertyChanged

使用CommunityToolkit的ObservableObject基类简化实现：

public partial class Team : ObservableObject {
    private int _teamId;
    [PrimaryKey, AutoIncrement]
    public int TeamId {
        get => _teamId;
        set => SetProperty(ref _teamId, value);
    }

    private string _name;
    public string Name {
        get => _name;
        set => SetProperty(ref _name, value);
    }
    // 其他属性同理封装
}

这样当EF Core更新实体的Name属性时，会触发PropertyChanged事件，CollectionView会自动刷新对应项的UI。

2. 解除EF Core对列表实体的跟踪（避免内存中实体被意外修改）

在_viewTeamsUseCase的查询逻辑中，使用AsNoTracking()让EF不跟踪返回的实体：

public async Task<List<Team>> ExecuteAsync(string filterText = null) {
    IQueryable<Team> query = _context.Teams.AsNoTracking();
    if (!string.IsNullOrEmpty(filterText)) {
        query = query.Where(t => t.Name.Contains(filterText));
    }
    return await query.ToListAsync();
}

这样列表中的实体不会被EF上下文跟踪，编辑操作不会直接修改列表中的实例，此时在OnAppearing时调用LoadTeamsAsync重新加载数据，就能确保CollectionView显示最新状态。

3. 优化ViewModel的集合更新逻辑

将Teams集合改为使用SetProperty封装（修正你之前尝试的语法错误）：

public partial class TeamsViewModel : ObservableObject {
    private ObservableCollection<Team> _teams = new();
    public ObservableCollection<Team> Teams {
        get => _teams;
        set => SetProperty(ref _teams, value);
    }

    // ...其他代码不变

    public async Task LoadTeamsAsync(string filterText = null) {
        var teams = await _viewTeamsUseCase.ExecuteAsync(filterText);
        Teams = new ObservableCollection<Team>(teams ?? Enumerable.Empty<Team>());
    }
}

直接替换整个ObservableCollection实例，通过SetProperty触发PropertyChanged事件，确保CollectionView感知到集合变化。

推荐方案组合 #

优先选择方案1+方案2：既让实体属性变更能通知UI，又避免EF跟踪导致的意外状态同步，同时保持列表加载的简洁性。

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