MAUI中XAML数据绑定失效问题求助

尝试将Model数据加载到XAML页面但绑定失效，已设置Label的绑定属性、指定BindingContext为MainPageViewModel，ViewModel中包含List<UserModel>类型的Userdata集合并添加了测试数据，以下是问题原因和修复方案：

核心问题分析 #

• 绑定路径错误：Userdata是List<UserModel>集合类型，直接通过{Binding Userdata.Username}无法访问到具体用户的属性——集合本身没有Username属性，必须指向集合中的单个元素。
• ViewModel未实现属性变更通知：ViewModel作为绑定源，若后续需要动态更新数据，未实现INotifyPropertyChanged会导致UI无法感知数据变化。
• 集合类型选择不当：List<T>不支持集合变更通知，当集合添加/删除元素时，UI不会自动刷新，应使用ObservableCollection<T>。

修复后的代码示例 #

1. 修正MainPageViewModel.cs #

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

namespace DatabindingNavListExample.ViewModels {
    public class MainPageViewModel : INotifyPropertyChanged {
        // 替换List为ObservableCollection，支持集合变更通知
        public ObservableCollection<UserModel> Userdata { get; set; } = new();

        public MainPageViewModel() { 
            Userdata.Add(new UserModel() { Username = "test", Firstname = "John", Lastname = "Doe"});
        }

        // 实现INotifyPropertyChanged接口
        public event PropertyChangedEventHandler PropertyChanged;
        protected void OnPropertyChanged([CallerMemberName] string propName = null) {
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propName));
        }
    }
}

2. XAML页面修正（两种可选方案） #

方案一：展示集合中的单个元素（比如第一个用户）

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="DatabindingNavListExample.MainPage"
             xmlns:models="clr-namespace:DatabindingNavListExample.Models"
             xmlns:viewmodels="clr-namespace:DatabindingNavListExample.ViewModels">
    <ScrollView>
        <VerticalStackLayout>
            <!-- 通过索引访问集合中的第一个元素 -->
            <Label FontSize="50" Text="{Binding Userdata[0].Username}" />
            <Label FontSize="50" Text="{Binding Userdata[0].Firstname}" />
            <Label FontSize="50" Text="{Binding Userdata[0].Lastname}" />
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

方案二：使用CollectionView展示所有用户数据

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="DatabindingNavListExample.MainPage"
             xmlns:models="clr-namespace:DatabindingNavListExample.Models"
             xmlns:viewmodels="clr-namespace:DatabindingNavListExample.ViewModels">
    <ScrollView>
        <CollectionView ItemsSource="{Binding Userdata}">
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <VerticalStackLayout Margin="10">
                        <Label FontSize="50" Text="{Binding Username}" />
                        <Label FontSize="50" Text="{Binding Firstname}" />
                        <Label FontSize="50" Text="{Binding Lastname}" />
                        <BoxView HeightRequest="1" Color="Gray" Margin="0,10" />
                    </VerticalStackLayout>
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </ScrollView>
</ContentPage>

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