.NET MAUI：ObservableCollection项无法绑定到自定义ContentView属性

以下是针对你遇到的绑定失效、显示空项问题的具体排查步骤：

• 确认TrackModel的属性合规性
  必须保证TrackModel的属性是public访问级别，并且实现了属性变更通知（比如通过INotifyPropertyChanged接口，或者用.NET MAUI的[ObservableProperty]特性）。示例代码：

  public partial class TrackModel : ObservableObject
  {
      [ObservableProperty]
      private string _trackName;
  
      [ObservableProperty]
      private string _artistName;
      // 其他需要展示的属性
  }
  

  如果属性是私有/保护级别，绑定无法访问；如果没有变更通知，UI也不会同步数据。

• 检查ViewModel的数据源
  确保MusicPageViewModel中的曲目集合是ObservableCollection<TrackModel>（实现了集合变更通知），且确实填充了19个有效的TrackModel实例，而非null。示例：

  public partial class MusicPageViewModel : ObservableObject
  {
      [ObservableProperty]
      private ObservableCollection<TrackModel> _tracks;
  
      public MusicPageViewModel()
      {
          Tracks = new ObservableCollection<TrackModel>
          {
              new TrackModel { TrackName = "测试曲目1", ArtistName = "测试歌手1" },
              // 剩余18个有效实例
          };
      }
  }
  

  用普通List<T>的话，CollectionView无法感知集合变化；如果集合项是null，自然会显示空项。

• 验证自定义组件的Track属性是可绑定属性
  自定义组件的Track属性不能是普通CLR属性，必须定义为BindableProperty，否则XAML绑定无法生效。示例：

  public partial class TrackListItemComponent : ContentView
  {
      public static readonly BindableProperty TrackProperty =
          BindableProperty.Create(nameof(Track), typeof(TrackModel), typeof(TrackListItemComponent), null);
  
      public TrackModel Track
      {
          get => (TrackModel)GetValue(TrackProperty);
          set => SetValue(TrackProperty, value);
      }
  }
  

• 检查CollectionView的ItemTemplate绑定语法
  主页面中CollectionView的ItemTemplate必须正确将当前项绑定到组件的Track属性，同时确认页面的BindingContext已设置为MusicPageViewModel实例。示例XAML：

  <CollectionView ItemsSource="{Binding Tracks}">
      <CollectionView.ItemTemplate>
          <DataTemplate>
              <local:TrackListItemComponent Track="{Binding}" />
          </DataTemplate>
      </CollectionView.ItemTemplate>
  </CollectionView>
  

  如果绑定路径写错（比如写成{Binding Track}），或者未设置ItemTemplate，都会导致空项。

• 排查组件内部UI绑定
  确保TrackListItemComponent内部的控件正确绑定到Track属性的子属性。比如：

  <ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               x:Class="YourApp.TrackListItemComponent"
               x:Name="componentRoot">
      <StackLayout>
          <Label Text="{Binding Source={x:Reference componentRoot}, Path=Track.TrackName}" />
          <Label Text="{Binding Source={x:Reference componentRoot}, Path=Track.ArtistName}" />
      </StackLayout>
  </ContentView>
  

  内部控件绑定路径错误的话，即使Track属性绑定成功，UI也不会显示内容。

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