.NET Maui 6.0 XAML数据绑定数组报错：对象未引用实例

问题原因 #

XAML编译器在编译阶段会提前解析绑定路径，此时MixingPage的BindingContext还未被设置为初始化后的Song实例，导致Effects[0].EffectItems在编译时处于null状态，触发空引用错误。该问题与Effect是否为抽象类、集合是数组还是List无关。

解决方案 #

1. 在绑定路径中使用空条件运算符（?.） #

修改XAML中的绑定表达式，通过?.避免中间对象为null时的报错，运行时数据加载完成后会正常显示值：

<Label Grid.Column="0"
       Text="{Binding Effects[0]?.EffectItems.Length}"
       VerticalOptions="Center"
       Margin="10,0" />

如果要绑定EffectItem的具体属性，同样使用空条件：

<Label Text="{Binding Effects[0]?.EffectItems[0]?.Value}" />

2. 为嵌套属性设置默认初始化值 #

在Effect类中，提前将EffectItems初始化为空集合，确保编译时路径解析不会遇到null：

public abstract class Effect
{
    // 初始化空数组，避免编译时null引用
    public EffectItem[] EffectItems { get; set; } = Array.Empty<EffectItem>();
    // 其他属性定义
}

如果使用List<EffectItem>，则初始化为空List：

public List<EffectItem> EffectItems { get; set; } = new List<EffectItem>();

3. 可选：实现INotifyPropertyChanged（如需动态更新） #

如果后续需要动态修改EffectItems并同步UI，建议让Song、Effect、EffectItem类实现INotifyPropertyChanged接口，并将集合改为ObservableCollection<T>：

public abstract class Effect : INotifyPropertyChanged
{
    private ObservableCollection<EffectItem> _effectItems = new();
    public ObservableCollection<EffectItem> EffectItems
    {
        get => _effectItems;
        set
        {
            _effectItems = value;
            OnPropertyChanged();
        }
    }

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

验证修改 #

按照上述方案调整后，编译阶段不会再触发空引用错误，运行时BindingContext赋值后，绑定会正常读取EffectItems中的数据。

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