MAUI Windows桌面应用ListView数据加载正常但内容不显示

以下是针对你遇到的“ListView计数正确但显示空白条目”问题的具体排查方向和解决方案：

1. 检查模型类的属性配置 #

• 确保模型的属性是公共且带有getter，如果需要动态更新数据，还需实现INotifyPropertyChanged接口（静态展示至少保证公共getter）。很多绑定失败都是因为属性权限不足或缺少通知机制：

  // 正确的模型示例（支持动态更新）
  public class YourModel : INotifyPropertyChanged
  {
      private string _itemName;
      public string ItemName
      {
          get => _itemName;
          set
          {
              _itemName = value;
              OnPropertyChanged();
          }
      }
  
      public event PropertyChangedEventHandler PropertyChanged;
      protected void OnPropertyChanged([CallerMemberName] string propertyName = null)
      {
          PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
      }
  }
  

• 若仅静态展示，可简化为public string ItemName { get; set; }，但必须保证get访问器存在。

2. 验证ItemTemplate的绑定路径 #

• XAML中绑定的属性名称必须与模型属性完全大小写匹配，MAUI绑定对大小写敏感：
  错误示例（大小写不匹配）：

  <ListView.ItemTemplate>
      <DataTemplate>
          <ViewCell>
              <Label Text="{Binding itemname}" />
          </ViewCell>
      </DataTemplate>
  </ListView.ItemTemplate>
  

  正确示例：

  <ListView.ItemTemplate>
      <DataTemplate>
          <ViewCell>
              <Label Text="{Binding ItemName}" />
          </ViewCell>
      </DataTemplate>
  </ListView.ItemTemplate>
  

3. 确认ItemsSource的赋值与数据上下文 #

• 直接赋值方式：确保后台代码将查询到的集合正确赋值给ListView的ItemsSource：

  // 假设queryResult是从数据库获取的8条数据集合
  YourListView.ItemsSource = queryResult;
  

• 绑定方式：若用MVVM或页面绑定，需确保页面BindingContext正确设置，且绑定的集合是公共属性：
  后台设置BindingContext：

  // 绑定到页面自身（若集合定义在页面后台）
  this.BindingContext = this;
  // 或绑定到ViewModel实例
  this.BindingContext = new YourPageViewModel();
  

  XAML绑定：

  <ListView ItemsSource="{Binding DataCollection}">
      <!-- ItemTemplate -->
  </ListView>
  

  注意：推荐使用ObservableCollection<T>作为集合类型，它能自动通知ListView集合变化。

4. 排查控件可见性与样式问题 #

• 可能存在控件文本颜色与背景色一致的情况，导致视觉上显示空白。可临时修改控件样式排查：

  <Label Text="{Binding ItemName}" BackgroundColor="Orange" TextColor="Black" />
  

5. 开启绑定调试日志 #

• 在App.xaml.cs的CreateMauiApp方法中添加调试配置，查看具体绑定错误：

  builder.ConfigureMauiHandlers(handlers =>
  {
      Microsoft.Maui.Controls.Log.Listeners.Add(new Microsoft.Maui.Controls.Logging.DebugTraceListener());
  });
  

  然后在Visual Studio的输出窗口中筛选“Binding”相关日志，若出现Binding: 'XXX' property not found on 'YYY'，直接定位到绑定路径错误。

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