.NET MAUI CollectionView绑定问题：DataContext中未找到FileName属性

看起来你在.NET MAUI的CollectionView绑定FileName属性时遇到了麻烦，别慌，咱们一步步排查常见问题点，大概率能解决这个问题：

• 先确认FileData类的FileName属性是否合规
  绑定系统只能访问公共可访问且带有getter的属性，很多时候问题就出在这儿。检查你的FileData类是不是这样写的：

  public class FileData
  {
      // 必须是public且包含getter，绑定才能识别
      public string FileName { get; set; }
      // 其他属性...
  }
  

  如果属性是private或者只有setter，绑定肯定找不到它。

• 检查CollectionView的ItemsSource和ItemTemplate绑定
  首先确保ItemsSource绑定到了你ViewModel里的ObservableCollection，而且ItemTemplate里的绑定上下文是集合中的单个FileData对象，不用加集合前缀。比如：

  <CollectionView ItemsSource="{Binding UploadedFiles}">
      <!-- 这里的UploadedFiles要和ViewModel里的集合名称完全一致 -->
      <CollectionView.ItemTemplate>
          <DataTemplate>
              <!-- 直接绑定FileName，因为此时上下文是单个FileData实例 -->
              <Label Text="{Binding FileName}" />
          </DataTemplate>
      </CollectionView.ItemTemplate>
  </CollectionView>
  

• 确认ViewModel的集合属性配置正确
  集合必须是public的，而且要记得初始化ObservableCollection，不然绑定会失效。比如在ViewModel里：

  public ObservableCollection<FileData> UploadedFiles { get; set; }
  
  public UserProfileMauiViewModel(IFileUploadService fileUploadService)
  {
      _fileUploadService = fileUploadService;
      // 一定要初始化集合，不然绑定找不到数据源
      UploadedFiles = new ObservableCollection<FileData>();
      // 其他初始化逻辑...
  }
  

• 检查页面的DataContext是否正确设置
  确保你的ViewModel已经被设置为页面的BindingContext，不然页面根本找不到ViewModel里的属性。可以在XAML里设置：

  <ContentPage ...
               xmlns:vm="clr-namespace:Deploy.WorkTime.MAUI.ViewModel"
               BindingContext="{StaticResource UserProfileMauiViewModel}">
  

  或者在页面后台代码绑定：

  public UserProfilePage()
  {
      InitializeComponent();
      BindingContext = new UserProfileMauiViewModel(/* 注入对应的服务实例 */);
  }
  

• 开启绑定调试排查细节
  如果还是找不到问题，可以开启MAUI的绑定调试，查看具体错误提示。在App.xaml.cs里添加：

  public App()
  {
      InitializeComponent();
      // 开启绑定调试日志
      Microsoft.Maui.Controls.Logging.ConfigureLogging(logLevel => logLevel == LogLevel.Debug);
  }
  

  然后查看Visual Studio的输出窗口，里面会显示绑定失败的详细原因，比如“找不到属性FileName”或者“DataContext为null”之类的明确提示。

备注：内容来源于stack exchange，提问作者Hay Abados