.NET MAUI使用ObservableGroupedCollection时分组标题不显示

常见排查点及修复方案 #

1. 确认分组类的属性命名与绑定路径一致 #

确保你的AnimalGroup类中用于显示标题的属性（比如Name）是公共可访问的，且绑定路径完全匹配。

• 示例AnimalGroup类：

public class AnimalGroup : ObservableCollection<Animal>
{
    public string Name { get; }

    public AnimalGroup(string name, IEnumerable<Animal> animals) : base(animals)
    {
        Name = name;
    }
}

2. 检查CollectionView的分组配置 #

确保XAML中正确设置IsGrouped="True"，且GroupHeaderTemplate的绑定指向分组类的标题属性：

<CollectionView ItemsSource="{Binding AnimalGroups}" IsGrouped="True">
    <CollectionView.GroupHeaderTemplate>
        <DataTemplate x:DataType="local:AnimalGroup">
            <Label Text="{Binding Name}" FontSize="Large" FontAttributes="Bold" Margin="10"/>
        </DataTemplate>
    </CollectionView.GroupHeaderTemplate>
    <CollectionView.ItemTemplate>
        <DataTemplate x:DataType="local:Animal">
            <Label Text="{Binding Name}" Margin="20,5"/>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

3. 验证ViewModel中的数据源类型 #

确保ViewModel中的集合是ObservableCollection<AnimalGroup>（或ObservableGroupedCollection<TKey, TItem>），并正确初始化数据：

public partial class MainViewModel : ObservableObject
{
    [ObservableProperty]
    private ObservableCollection<AnimalGroup> _animalGroups;

    public MainViewModel()
    {
        AnimalGroups = new ObservableCollection<AnimalGroup>
        {
            new AnimalGroup("Bears", new List<Animal>
            {
                new Animal { Name = "Grizzly" },
                new Animal { Name = "Polar" }
            }),
            new AnimalGroup("Monkeys", new List<Animal>
            {
                new Animal { Name = "Capuchin" },
                new Animal { Name = "Howler" }
            })
        };
    }
}

4. 检查x:DataType的命名空间是否正确 #

在XAML根元素中确认命名空间声明正确，比如：

xmlns:local="clr-namespace:YourAppNamespace"

若AnimalGroup在其他命名空间下，需对应调整local的指向。

5. 确认页面的BindingContext设置正确 #

确保页面的BindingContext已关联到ViewModel，比如在代码后台：

public MainPage()
{
    InitializeComponent();
    BindingContext = new MainViewModel();
}

或在XAML中设置：

<ContentPage.BindingContext>
    <local:MainViewModel/>
</ContentPage.BindingContext>

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