PAYATHON 2026

.NET 9 Maui 如何在颜色属性变化后更新 CollectionView?

数据阿明

结论

可以继续使用 List<CryptoItem>。让 CryptoItem 实现 INotifyPropertyChanged,在颜色设置变化后,由每个需要更新的 CryptoItem 实例发出 ListTextColor 的属性变更通知。

通知必须来自 DataTemplate 当前绑定的条目对象。在页面或页面 ViewModel 上调用 OnPropertyChanged(nameof(ListTextColor)),不会通知绑定到 CryptoItem.ListTextColor 的 Label。

为什么滚动后才显示新颜色

ItemsSource="{Binding Items}" 和 TextColor="{Binding ListTextColor}" 的绑定源不同:前者读取页面绑定上下文中的 Items,后者读取当前条目的 ListTextColor。

OnPropertyChanged("Items") 通知的是列表属性变化,不会通知列表中各个对象的颜色属性变化。即使换成 ObservableCollection<CryptoItem>,条目自身的属性仍需发送通知。ObservableCollection 主要报告集合成员的增删、替换等变化。

滚动离开再回来时,条目视图可能重新绑定并读取颜色。这与缺少属性通知的现象相符。由于原问题没有提供 CryptoItem 的实现,还需要确认 ListTextColor 是计算属性,还是保存颜色值的属性。

如果 ListTextColor 根据偏好设置计算

假设现有的 ListTextColor getter 每次都根据条目状态和当前颜色设置返回结果,可以在现有 CryptoItem 类中加入通知机制。下面省略了已有的 Name 和 ListTextColor 实现,合并代码时需要保留它们:

using System.ComponentModel;
using System.Runtime.CompilerServices;

public class CryptoItem : INotifyPropertyChanged
{
    // 保留现有的 Name 和 ListTextColor 属性实现。

    public event PropertyChangedEventHandler? PropertyChanged;

    protected void OnPropertyChanged(
        [CallerMemberName] string? propertyName = null)
    {
        PropertyChanged?.Invoke(
            this,
            new PropertyChangedEventArgs(propertyName));
    }

    public void RefreshListTextColor()
    {
        OnPropertyChanged(nameof(ListTextColor));
    }
}

如果 CryptoItem 已继承提供 INotifyPropertyChanged 和 OnPropertyChanged 的基类,只需添加 RefreshListTextColor(),不要重复声明事件。

保存颜色设置后,通知列表中的相关实例。对于从 Options 页面返回列表页的流程,可以在列表页面的 OnAppearing() 中处理:

protected override void OnAppearing()
{
    base.OnAppearing();

    if (ItemsList.ItemsSource is IEnumerable<CryptoItem> items)
    {
        foreach (var item in items)
        {
            item.RefreshListTextColor();
        }
    }
}

这段代码使用现有的 ItemsList,遍历它实际绑定的对象。运行时颜色设置应已保存,ListTextColor 的 getter 也要能读取更新后的设置。如果 getter 使用了缓存,需要先更新缓存,再发出通知。

原有 XAML 可以保持不变:

<Label
    Text="{Binding Name}"
    LineBreakMode="NoWrap"
    FontSize="Medium"
    FontAttributes="Bold"
    HorizontalTextAlignment="Start"
    TextColor="{Binding ListTextColor}" />

如果 ListTextColor 保存的是颜色值

如果 ListTextColor 使用字段保存颜色,仅发送通知会让绑定重新读取原来的值。需要先根据最新设置计算颜色,再给属性赋值。

在已经实现上述通知机制的 CryptoItem 类中,可以使用这样的属性:

private Color _listTextColor = Colors.Black;

public Color ListTextColor
{
    get => _listTextColor;
    set
    {
        if (Equals(_listTextColor, value))
            return;

        _listTextColor = value;
        OnPropertyChanged();
    }
}

此处需要 Microsoft.Maui.Graphics 命名空间。Colors.Black 只是示例初始值,应按应用的默认配色调整。

保存偏好设置后,对受影响的条目重新计算颜色,并执行 item.ListTextColor = 新颜色。setter 会发送通知。原问题没有提供状态字段和设置读取代码,因此这部分应沿用应用已有的颜色判断逻辑。

实现时需要确认的细节

  • 发出通知的对象必须是 ItemsSource 中的同一实例。修改另一个新建的 CryptoItem 不会更新当前条目。
  • 如果颜色设置在返回页面前已保存,可以在 OnAppearing() 中遍历并通知条目,便于接入现有流程。列表较大时,可以只通知颜色受影响的条目。
  • 如果通过设置变更事件立即更新颜色,应管理好事件订阅与取消订阅,避免重复处理。
  • 如果更新入口来自后台线程,可以用 MainThread.BeginInvokeOnMainThread 将颜色赋值和通知操作安排到 UI 线程。

备注:内容仅供参考。