.NET MAUI CommunityToolkit.Mvvm：如何绑定自定义对象而非字符串

一、ItemGroup类的推荐存放位置 #

1. 首选：项目根目录下的Models文件夹
   这是MVVM架构中存放数据模型的标准位置，逻辑清晰，便于后续维护和复用。
2. 备选：MainView/ViewModel文件夹
   如果想和ViewModel放在同一目录也可行，但要保证命名空间和ViewModel保持统一。
3. 不推荐：嵌套在MainViewModel类中
   嵌套类会增加XAML引用的复杂度，且不利于代码的独立复用。

二、必须的命名空间声明 #

情况1：ItemGroup放在Models文件夹 #

1. ItemGroup类的命名空间（替换YourAppName为你的项目名称）：

namespace YourAppName.Models;

2. 在MainPage.xaml头部添加命名空间引用：

xmlns:models="clr-namespace:YourAppName.Models"

情况2：ItemGroup放在MainView/ViewModel文件夹 #

1. ItemGroup类的命名空间：

namespace YourAppName.MainView.ViewModel;

2. 在MainPage.xaml头部添加（如果已经声明过vm命名空间可直接复用）：

xmlns:vm="clr-namespace:YourAppName.MainView.ViewModel"

三、解决访问问题的核心注意事项 #

1. ItemGroup类必须设为public
   默认的internal访问修饰符会导致XAML无法访问，代码示例：

public class ItemGroup
{
    public bool IsChecked { get; set; }
    public string Name { get; set; } = string.Empty;
}

2. ViewModel中正确引用ItemGroup
   在MainViewModel中导入ItemGroup对应的命名空间，声明可绑定集合：

using YourAppName.Models; // 对应存放位置的命名空间
using CommunityToolkit.Mvvm.ComponentModel;
using System.Collections.ObjectModel;

namespace YourAppName.MainView.ViewModel;

public partial class MainViewModel : ObservableObject
{
    [ObservableProperty]
    private ObservableCollection<ItemGroup> _items = new()
    {
        new ItemGroup { IsChecked = false, Name = "测试项1" },
        new ItemGroup { IsChecked = true, Name = "测试项2" }
    };
}

3. XAML绑定匹配属性名
   确保绑定的属性名和ItemGroup类中的成员完全一致（C#属性建议用大驼峰命名，比如Name而非name）。

四、XAML绑定示例 #

以ListView绑定ObservableCollection<ItemGroup>为例：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:vm="clr-namespace:YourAppName.MainView.ViewModel"
             xmlns:models="clr-namespace:YourAppName.Models"
             x:Class="YourAppName.MainView.MainPage"
             BindingContext="{StaticResource MainViewModel}">

    <ListView ItemsSource="{Binding Items}">
        <ListView.ItemTemplate>
            <DataTemplate>
                <ViewCell>
                    <HorizontalStackLayout Padding="10">
                        <CheckBox IsChecked="{Binding IsChecked}" VerticalOptions="Center" />
                        <Label Text="{Binding Name}" FontSize="16" VerticalOptions="Center" />
                    </HorizontalStackLayout>
                </ViewCell>
            </DataTemplate>
        </ListView.ItemTemplate>
    </ListView>
</ContentPage>

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