本示例演示 Windows Presentation Foundation (WPF) 客户端中数据绑定的用法。 此示例使用随机生成一个数组的唱片集以返回到客户端的 Windows Communication Foundation (WCF) 服务。 每个唱片集都有名称、价格和唱片集曲目列表。 唱片集曲目具有名称和持续时间。 服务返回的信息自动绑定到 Windows Presentation Foundation (WPF) 客户端提供的用户界面 (UI) 中。
Note: 本主题的最后介绍了此示例的设置过程和生成说明。
使用数据绑定可以将数据源自动绑定到 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 绑定到不同的属性。 这是因为两个模板用于不同的数据对象。
设置、生成和运行示例
-
若要生成 C# 或 Visual Basic .NET 版本的解决方案,请按照 Building the Windows Communication Foundation Samples中的说明进行操作。
-
若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。
Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:
<InstallDrive>:\WF_WCF_Samples如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:
<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\DataBinding\WPFDataBinding
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
