绑定分层数据并使用 WinUI 创建主视图/详细信息视图

了解如何通过将项控件绑定到 CollectionViewSource 实例,在 WinUI 中创建分层数据的多层主视图/详细信息视图。 本文介绍如何使用 {x:Bind} 标记扩展 来提高性能,以及在需要灵活性时使用 {Binding} 标记扩展

WinUI 应用的一个常见结构是当用户在主列表中做出选择时导航到不同的详细信息页。 如果要在层次结构中的每个级别提供每个项的丰富可视表示形式,此结构非常有用。 另一种选择是在一个页面上显示多级数据。 如果要显示几个简单列表,让用户快速向下钻取到感兴趣的项,此结构非常有用。 本文介绍如何实现此交互。 CollectionViewSource 实例跟踪每个分层级别的当前选择。

你可以创建一个体育团队层次结构的视图,该层次结构已组织成联盟、部门和团队的列表,并包括团队详细信息视图。 当你从任一列表中选择一个项目时,会自动更新后续视图。

运动层次结构的主视图/详细信息视图的屏幕截图。视图包括联赛、分区和球队。

小窍门

另请参阅大纲/细节 UWP 示例

先决条件

本文假设你知道如何创建基本的 WinUI 应用。 有关创建第一个 WinUI 应用的说明,请参阅 “创建 WinUI 应用”。

创建项目

创建一个新的“打包的空白应用(桌面版 WinUI 3)”项目。 将其命名为“MasterDetailsBinding”。

创建数据模型

向项目添加一个新类、将其命名为 ViewModel.cs,并向其中添加此代码。 此类是绑定源类。

using System.Collections.Generic;
using System.Linq;

namespace MasterDetailsBinding
{
    public class Team
    {
        public string Name { get; set; }
        public int Wins { get; set; }
        public int Losses { get; set; }
    }

    public class Division
    {
        public string Name { get; set; }
        public IEnumerable<Team> Teams { get; set; }
    }

    public class League
    {
        public string Name { get; set; }
        public IEnumerable<Division> Divisions { get; set; }
    }

    public class LeagueList : List<League>
    {
        public LeagueList()
        {
            AddRange(GetLeague().ToList());
        }

        public IEnumerable<League> GetLeague()
        {
            return from x in Enumerable.Range(1, 2)
                   select new League
                   {
                       Name = "League " + x,
                       Divisions = GetDivisions(x).ToList()
                   };
        }

        public IEnumerable<Division> GetDivisions(int x)
        {
            return from y in Enumerable.Range(1, 3)
                   select new Division
                   {
                       Name = string.Format("Division {0}-{1}", x, y),
                       Teams = GetTeams(x, y).ToList()
                   };
        }

        public IEnumerable<Team> GetTeams(int x, int y)
        {
            return from z in Enumerable.Range(1, 4)
                   select new Team
                   {
                       Name = string.Format("Team {0}-{1}-{2}", x, y, z),
                       Wins = 25 - (x * y * z),
                       Losses = x * y * z
                   };
        }
    }
}

创建视图

接下来,从表示标记页的类公开绑定源类。 向 LeagueList 添加类型属性。

namespace MasterDetailsBinding
{
    public sealed partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            ViewModel = new LeagueList();
        }
        public LeagueList ViewModel { get; set; }
    }
}

最后,将 MainWindow.xaml 文件的内容替换为以下标记。 此标记声明三个 CollectionViewSource 实例,并在链中将它们绑定在一起。 后续控件可以根据其在层次结构中的级别绑定到相应的 CollectionViewSource

<Window
    x:Class="MasterDetailsBinding.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:MasterDetailsBinding"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <Grid>
        <Grid.Resources>
            <CollectionViewSource x:Name="Leagues"
                Source="{x:Bind ViewModel}"/>
            <CollectionViewSource x:Name="Divisions"
                Source="{Binding Divisions, Source={StaticResource Leagues}}"/>
            <CollectionViewSource x:Name="Teams"
                Source="{Binding Teams, Source={StaticResource Divisions}}"/>
    
            <Style TargetType="TextBlock">
                <Setter Property="FontSize" Value="15"/>
                <Setter Property="FontWeight" Value="Bold"/>
            </Style>
            <Style TargetType="ListBox">
                <Setter Property="FontSize" Value="15"/>
            </Style>
            <Style TargetType="ContentControl">
                <Setter Property="FontSize" Value="15"/>
            </Style>
        </Grid.Resources>

        <StackPanel Orientation="Horizontal">

            <!-- All Leagues view -->
            <StackPanel Margin="5">
                <TextBlock Text="All Leagues"/>
                <ListBox ItemsSource="{Binding Source={StaticResource Leagues}}" 
                         DisplayMemberPath="Name"/>
            </StackPanel>

            <!-- League/Divisions view -->
            <StackPanel Margin="5">
                <TextBlock Text="{Binding Name, Source={StaticResource Leagues}}"/>
                <ListBox ItemsSource="{Binding Source={StaticResource Divisions}}" 
                         DisplayMemberPath="Name"/>
            </StackPanel>

            <!-- Division/Teams view -->
            <StackPanel Margin="5">
                <TextBlock Text="{Binding Name, Source={StaticResource Divisions}}"/>
                <ListBox ItemsSource="{Binding Source={StaticResource Teams}}" 
                         DisplayMemberPath="Name"/>
            </StackPanel>

            <!-- Team view -->
            <ContentControl Content="{Binding Source={StaticResource Teams}}">
                <ContentControl.ContentTemplate>
                    <DataTemplate>
                        <StackPanel Margin="5">
                            <TextBlock Text="{Binding Name}" 
                                       FontSize="15" FontWeight="Bold"/>
                            <StackPanel Orientation="Horizontal" Margin="10,10">
                                <TextBlock Text="Wins:" Margin="0,0,5,0"/>
                                <TextBlock Text="{Binding Wins}"/>
                            </StackPanel>
                            <StackPanel Orientation="Horizontal" Margin="10,0">
                                <TextBlock Text="Losses:" Margin="0,0,5,0"/>
                                <TextBlock Text="{Binding Losses}"/>
                            </StackPanel>
                        </StackPanel>
                    </DataTemplate>
                </ContentControl.ContentTemplate>
            </ContentControl>
        </StackPanel>
    </Grid>
</Window>

直接绑定到 CollectionViewSource 时,表示要绑定到绑定中的当前项,在该绑定中找不到集合本身的路径。 无需将 CurrentItem 属性指定为绑定的路径,但如果存在任何歧义,可以添加它。 例如,表示团队视图的 ContentControl 然而,DataTemplate 中的控件被绑定到 类的属性,因为 Team 会自动按需提供团队列表中当前所选的团队。

另请参阅