UWP ListView分组绑定CollectionViewSource报错及自定义组头问题

一、CollectionViewSource绑定抛错修复 #

你遇到的绑定报错截图如下：

报错核心原因是直接将CollectionViewSource实例赋值给ListView.ItemsSource——ItemsSource要求接收可枚举的集合对象，而CollectionViewSource是集合视图的托管容器，本身不是可直接绑定的数据源。
修复步骤：

• 若使用XAML配置：先在窗口/控件资源中定义CollectionViewSource，指定数据源和分组规则，再绑定到CollectionViewSource生成的视图

  <Window.Resources>
      <!-- 绑定ViewModel中的PlayerData类型ObservableCollection集合，替换PlayerList为你实际的集合属性名 -->
      <CollectionViewSource x:Key="PlayerGroupSource" Source="{Binding PlayerList}">
          <!-- 配置分组依据，替换Category为PlayerData类中实际的类别属性名 -->
          <CollectionViewSource.GroupDescriptions>
              <PropertyGroupDescription PropertyName="Category" />
          </CollectionViewSource.GroupDescriptions>
      </CollectionViewSource>
  </Window.Resources>
  
  <ListView 
      x:Name="PlayerListView" 
      IsGrouping="True"
      ItemsSource="{Binding Source={StaticResource PlayerGroupSource}}">
      <!-- 列表列、项模板内容 -->
  </ListView>
  

• 若使用后台代码赋值：不要直接赋值CollectionViewSource对象，要取它的View属性赋值

  // 假设你已经初始化好名为playerCvs的CollectionViewSource对象
  PlayerListView.ItemsSource = playerCvs.View;
  

注意：ListView必须开启IsGrouping="True"，否则分组规则不会生效。

二、自定义GroupHeaderTemplate实现 #

自定义分组表头只需要为ListView配置GroupStyle，在样式中重写HeaderTemplate即可，模板的数据上下文是自动生成的CollectionViewGroup对象，可直接绑定分组相关属性。
示例代码：

<ListView.GroupStyle>
    <GroupStyle>
        <!-- 调整分组容器边距，可按需修改 -->
        <GroupStyle.ContainerStyle>
            <Style TargetType="GroupItem">
                <Setter Property="Margin" Value="0 5 0 5"/>
            </Style>
        </GroupStyle.ContainerStyle>
        <!-- 自定义组头模板 -->
        <GroupStyle.HeaderTemplate>
            <DataTemplate>
                <Grid Background="#e8f4f8" Padding="8 4">
                    <StackPanel Orientation="Horizontal">
                        <!-- Name是当前分组的类别值，即分组属性对应的具体内容 -->
                        <TextBlock Text="{Binding Name}" FontWeight="Bold" FontSize="14" Foreground="#165DFF"/>
                        <!-- ItemCount是当前分组下的玩家总数 -->
                        <TextBlock Text="{Binding StringFormat=共{0}人, Path=ItemCount}" Margin="10 0 0 0" Foreground="#666"/>
                    </StackPanel>
                </Grid>
            </DataTemplate>
        </GroupStyle.HeaderTemplate>
    </GroupStyle>
</ListView.GroupStyle>

模板中可使用的CollectionViewGroup常用绑定属性：

• Name：当前分组的键值，即你指定的分组属性对应的具体类别名
• ItemCount：当前分组包含的子项总数
• Items：当前分组下的所有子项集合，可用于做更复杂的自定义展示

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