通过

Windows Presentation Foundation 客户端中的数据绑定

  • 项目

WPFDataBinding 示例演示 Windows Presentation Foundation (WPF) 客户端中数据绑定的用法。 本示例使用一个 Windows Communication Foundation (WCF) 服务，该服务随机生成一个要返回到客户端的唱片集数组。 每个唱片集都有名称、价格和唱片集曲目列表。 唱片集曲目具有名称和持续时间。 服务返回的信息自动绑定到由 Windows Presentation Foundation (WPF) 客户端提供的用户接口 (UI)。

注意

本主题的最后介绍了此示例的设置过程和生成说明。

使用数据绑定可以将数据源自动绑定到 UI。 这简化了编程模型，因为它不需要您以编程方式使用数据对象中的数据或数据对象数组中的数据更新每个 UI 元素。 您可以将对象绑定到单个 UI 元素或将数组绑定到采用多个输入的控件（如 ListBox）。 下面的代码演示如何将数据绑定到 UI 元素的 DataContext。

// Event handler executed when call is complete
void client_GetAlbumListCompleted(object sender, GetAlbumListCompletedEventArgs e)
{
    // This is on the UI thread, myPanel can be accessed directly
    myPanel.DataContext = e.Result;
}

在前面的示例中，将名为 DataContext 的 grid 布局元素的 myPanel 设置为 GetAlbumList 方法返回的数据。 DataContext 使元素可以从它们的父元素继承有关用于绑定的数据源以及绑定的其他特征（例如路径）的信息。 每次更新服务器上的数据时，必须执行该代码行。 例如，初始化窗口时和添加新唱片集时执行该代码行。

在下面的示例 XAML 代码中，ListBox 指定 ItemsSource="{Binding }"。

<ListBox
          ItemTemplate="{StaticResource AlbumStyle}"
          ItemsSource="{Binding }"
          IsSynchronizedWithCurrentItem="true" />

这将指定绑定到顶级 UI 元素的数据也绑定到此控件（即唱片集数组）。 此外，ItemTemplate="{StaticResource AlbumStyle}" 指定将用于 ListBox 中每个项的数据模板。 您也可以定义数据模板以指定应如何格式化数据。 应用程序中的其他 UI 元素可以重复使用这些数据模板，优点是在同一位置定义和维护数据模板。

AlbumStyle 数据模板并排使用两个 TextBlock 布置网格。 一个指定唱片集的名称，另一个指定唱片集中的曲目数。

<DataTemplate x:Key="AlbumStyle">
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="260" />
            <ColumnDefinition Width="60" />
        </Grid.ColumnDefinitions>
        <TextBlock Grid.Column="0" TextContent="{Binding Path=Title}" />
        <TextBlock Grid.Column="1" TextContent="{Binding Path=Tracks#.Count}" HorizontalAlignment="Right" />
    </Grid>
</DataTemplate>

下面的 XAML 代码创建另一个 ListBox。

<ListBox Grid.Row="2"
            Grid.ColumnSpan="2"
            ItemTemplate="{StaticResource TrackStyle}"
            ItemsSource="{Binding Path=Tracks}" />

该代码指定 ItemsSource 的路径。 这表示绑定到此控件的数据不是顶级数据，而是名为 Tracks 的顶级数据的属性。 此属性表示唱片集内包含的曲目数组。 此外，指定了名为 DataTemplate 的另一个 TrackStyle。 TrackStyle 模板的布局类似于 AlbumStyle 模板的布局，但 TextBlock 绑定到不同的属性。 这是因为两个模板用于不同的数据对象。

设置、生成和运行示例

  1. 请确保已执行 Windows Communication Foundation 示例的一次性安装过程。

  2. 若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照 Building the Windows Communication Foundation Samples中的说明进行操作。

  3. 要使用单机配置或跨计算机配置来运行示例，请按照运行 Windows Communication Foundation 示例中的说明进行操作。