.NET MAUI中子上下文绑定属性无法正常显示问题的解决求助

问题现象 #

页面中嵌套的CollectionView（基础CollectionView绑定对象的子元素）无法正常加载内容，仅在运行时修改绑定并触发热重载后才会显示；重启应用后绑定再次失效。同场景下的Picker控件也存在相同问题。

原XAML代码 #

<CollectionView ItemsSource="{Binding ListInViewModel}" SelectionMode="None" Margin="0, 10">
      <CollectionView.ItemsLayout>
        <LinearItemsLayout Orientation="Vertical" />
      </CollectionView.ItemsLayout>

      <CollectionView.ItemTemplate>
        <DataTemplate>
          <VerticalStackLayout>
             <Label Text="{Binding PropertyThatDisplaysCorrectly}" VerticalOptions="Center" />
<CollectionView Grid.Row="1" SelectionMode="Single" SelectedItem="{Binding SelectedString}" ItemsSource="{Binding StringListFromObjectInList}">
  <CollectionView.ItemsLayout>
    <LinearItemsLayout Orientation="Horizontal" ItemSpacing="10"/>
  </CollectionView.ItemsLayout>

  <CollectionView.ItemTemplate>
    <DataTemplate x:DataType="x:String">
      <Border Stroke="DarkGray" Padding="10">
        <Border.StrokeShape>
          <RoundRectangle CornerRadius="20"/>
        </Border.StrokeShape>
        <Label Text="{Binding}" VerticalOptions="Center" HorizontalOptions="Center" />
      </Border>
    </DataTemplate>
  </CollectionView.ItemTemplate>
</CollectionView>
          </VerticalStackLayout>
        </DataTemplate>
      </CollectionView.ItemTemplate>
    </CollectionView>

原ViewModel代码 #

public class MyViewModel
{
  private List<MyObject> _listInViewModel { get; set; }
  public MyViewModel()
  {
  }

  public List<MyObject> ListInViewModel
  {
    get => _listInViewModel;
    set
    {
      _listInViewModel = value;
      OnPropertyChanged(nameof(ListInViewModel));
    }
  }
}

public class MyObject 
{
  public List<string> StringListFromObjectInList { get; set; }
}

解决方法 #

1. 初始化集合避免Null引用 #

MyObject中的StringListFromObjectInList需要在实例化时完成初始化，避免绑定到空集合。List<T>是不可变集合，后续赋值无法触发变更通知，因此必须在构造阶段完成实例化。

2. 替换为ObservableCollection<T> #

List<T>不支持集合变更通知，当集合内容动态修改时UI无法同步更新。改用ObservableCollection<T>，它会自动触发集合变更事件，确保UI实时响应数据变化。

3. 为父级DataTemplate指定x:DataType #

父级DataTemplate未指定类型会导致绑定解析延迟或出错，明确指定类型可帮助XAML编译器提前校验绑定，避免运行时绑定失效。

修改后的代码示例 #

ViewModel代码 #

using System.Collections.ObjectModel;
using System.ComponentModel;
using System.Runtime.CompilerServices;

public class MyViewModel : INotifyPropertyChanged
{
    private ObservableCollection<MyObject> _listInViewModel;
    public ObservableCollection<MyObject> ListInViewModel
    {
        get => _listInViewModel;
        set
        {
            _listInViewModel = value;
            OnPropertyChanged();
        }
    }

    public MyViewModel()
    {
        // 初始化根集合
        ListInViewModel = new ObservableCollection<MyObject>();
        // 添加示例数据
        ListInViewModel.Add(new MyObject
        {
            PropertyThatDisplaysCorrectly = "测试项1",
            StringListFromObjectInList = new ObservableCollection<string> { "选项A", "选项B", "选项C" }
        });
    }

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

public class MyObject : INotifyPropertyChanged
{
    private string _propertyThatDisplaysCorrectly;
    public string PropertyThatDisplaysCorrectly
    {
        get => _propertyThatDisplaysCorrectly;
        set
        {
            _propertyThatDisplaysCorrectly = value;
            OnPropertyChanged();
        }
    }

    private ObservableCollection<string> _stringListFromObjectInList;
    public ObservableCollection<string> StringListFromObjectInList
    {
        get => _stringListFromObjectInList;
        set
        {
            _stringListFromObjectInList = value;
            OnPropertyChanged();
        }
    }

    public MyObject()
    {
        // 初始化子集合
        StringListFromObjectInList = new ObservableCollection<string>();
    }

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

XAML代码 #

<!-- 注意：需在页面根元素添加命名空间声明 xmlns:local="clr-namespace:你的命名空间" -->
<CollectionView ItemsSource="{Binding ListInViewModel}" SelectionMode="None" Margin="0, 10">
    <CollectionView.ItemsLayout>
        <LinearItemsLayout Orientation="Vertical" />
    </CollectionView.ItemsLayout>

    <CollectionView.ItemTemplate>
        <!-- 指定父级DataTemplate的绑定类型 -->
        <DataTemplate x:DataType="local:MyObject">
            <VerticalStackLayout>
                <Label Text="{Binding PropertyThatDisplaysCorrectly}" VerticalOptions="Center" />
                <CollectionView SelectionMode="Single" SelectedItem="{Binding SelectedString}" ItemsSource="{Binding StringListFromObjectInList}">
                    <CollectionView.ItemsLayout>
                        <LinearItemsLayout Orientation="Horizontal" ItemSpacing="10"/>
                    </CollectionView.ItemsLayout>

                    <CollectionView.ItemTemplate>
                        <DataTemplate x:DataType="x:String">
                            <Border Stroke="DarkGray" Padding="10">
                                <Border.StrokeShape>
                                    <RoundRectangle CornerRadius="20"/>
                                </Border.StrokeShape>
                                <Label Text="{Binding}" VerticalOptions="Center" HorizontalOptions="Center" />
                            </Border>
                        </DataTemplate>
                    </CollectionView.ItemTemplate>
                </CollectionView>
            </VerticalStackLayout>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

额外注意事项 #

• 确保页面BindingContext正确设置：在页面构造函数中添加BindingContext = new MyViewModel();
• 如果SelectedString是MyObject的属性，需为其实现INotifyPropertyChanged，否则选中状态变更无法同步到UI。

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