Silverlight WCF RIA服务（二十三）Silverlight 客户端 4_app

概述DomainDataSource WCF RIA Services提供DomainDataSource控件来简化用户界面和域上下文中数据的交互。通过DomainDataSource，我们可以只是用声明性语法来检索、编辑数据。我们指定域上下文与DomainDataSource一起使用，然后通过这个上下文来调用 *** 作。配置Silverlight应用程序的DomainDataSource 为了使用Dom

DomainDataSource
WCF RIA Services提供DomainDataSource控件来简化用户界面和域上下文中数据的交互。通过DomainDataSource，我们可以只是用声明性语法来检索、编辑数据。我们指定域上下文与DomainDataSource一起使用，然后通过这个上下文来调用 *** 作。
配置Silverlight应用程序的DomainDataSource
为了使用DomainDataSource控件，我们必须在包含DomainDataSource的SL控件中添加一个程序集的引用和命名空间。
在SL项目中,我们必须添加一个对System.windows.Controls.Ria程序集的引用。如果选择DataGrID与DomainDataSource一起使用，我们还要添加对System.windows.Controls.Data的引用。
在宿主控件内，例如UserControl，我们必须添加下面的命名空间引用：

1 2 3 4 5 xmlns:riaControls="clr-namespace:System.windows.Controls;assembly=System.windows.Controls.Ria" xmlns:riaData="clr-namespace:System.windows.Data;assembly=System.windows.Controls.Ria" xmlns:domain="clr-namespace:SilverlightApplication17.Web"

如果选择使用DataGrID控件，还需添加下面的命名空间：

1 2 3 xmlns:data="clr-namespace:System.windows.Controls;assembly=System.windows.Controls.Data"

检索和显示数据
我们为DomainDataSource指定一个域上下文，并向用户提供方法的名字来装载数据。然后我们绑定表示控件，例如DataGrID对DomainDataSource。下面的例子演示了DomainDataSource检索从名为ProductDomainContext的域上下文而来的数据。在域服务中应该存在一个名为GetProduct()的查询方法。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 <USERCONTRol <br x:Class="ExampleApplication.MainPage" /> xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:riaControls="clr-namespace:System.windows.Controls;assembly=System.windows.Controls.Ria" xmlns:riaData="clr-namespace:System.windows.Data;assembly=System.windows.Controls.Ria" xmlns:domain="clr-namespace:SilverlightApplication17.Web" xmlns:datac="clr-namespace:System.windows.Controls;assembly=System.windows.Controls.Data" mc:Ignorable="d"> <GRID x:name="LayoutRoot" Background="White"> <RIACONTRolS:DOMAINDATASOURCE x:name="source" autoLoad="true" queryname="GetProducts"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT> </DOMAIN:PRODUCTDOMAINCONTEXT> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> </RIACONTRolS:DOMAINDATASOURCE> <DATAC:DATAGRID ItemsSource="{Binding Data,Elementname=source}"> </DATAC:DATAGRID> </GRID> </USERCONTRol>

对查询添加参数
某些情况下，查询方法需要参数值。通常，一个查询方法需要一个参数值来过滤返回的数据。下面的示例演示如何添加参数值，这个值可通过声明性文本来指定。

1 2 3 4 5 6 7 8 9 10 11 12 13 <GRID x:name="LayoutRoot" Background="White"> <RIACONTRolS:DOMAINDATASOURCE x:name="source" autoLoad="true" queryname="GetProductsBycolor"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT /> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <RIACONTRolS:DOMAINDATASOURCE.queryParaMETERS> <RIADATA:ParaMETER Parametername="color" Value="Black" /> </RIACONTRolS:DOMAINDATASOURCE.queryParaMETERS> </RIACONTRolS:DOMAINDATASOURCE> <DATAC:DATAGRID ItemsSource="{Binding Data,Elementname=source}" /> </GRID>

还可以使用来自用户的值来为查询添加参数。我们使用ControlParameter对象来把来自用户输入控件的值传递到查询。下面的例子展示了如何指定来自下拉菜单中的值做为参数值。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 <GRID x:name="LayoutRoot" Background="White"> <GRID.ROWDEFinitioNS> <ROWDEFinitioN Height="25" /> <ROWDEFinitioN Height="auto" /> </GRID.ROWDEFinitioNS> <RIACONTRolS:DOMAINDATASOURCE x:name="source" autoLoad="true" queryname="GetProductsBycolor"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT /> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <RIACONTRolS:DOMAINDATASOURCE.queryParaMETERS> <RIACONTRolS:CONTRolParaMETER Parametername="color" Controlname="colorCombo" Propertyname="SelectedItem.Content" RefreshEventname="SelectionChanged" /> </RIACONTRolS:DOMAINDATASOURCE.queryParaMETERS> </RIACONTRolS:DOMAINDATASOURCE> <COMBOBox x:name="colorCombo" GrID.Row="0" WIDth="60"> <COMBOBoxITEM Content="Black" /> <COMBOBoxITEM Content="Blue" /> </COMBOBox> <DATAC:DATAGRID GrID.Row="1" ItemsSource="{Binding Data,Elementname=source}" /> </GRID>

排序
DomainDataSource提供SortDescriptors集合来简化数据的排序。在SortDescriptors集合中，我们提供SortDescriptor实例来向用户描述参数值。我们可以添加多个SortDescriptor实例。还可以指定数据排序的升降序。下面的示例演示DomainDataSource中的排序描述符，从查询中检索的数据按来自StandardPrice属性中的值排序。

1 2 3 4 5 6 7 8 9 10 11 12 13 <GRID x:name="LayoutRoot" Background="White"> <RIACONTRolS:DOMAINDATASOURCE x:name="source" autoLoad="true" queryname="GetProducts"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT /> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <RIACONTRolS:DOMAINDATASOURCE.soRTDESCRIPTORS> <RIADATA:SORTDESCRIPTOR Direction="Ascending" PropertyPath="Standardcost" /> </RIACONTRolS:DOMAINDATASOURCE.soRTDESCRIPTORS> </RIACONTRolS:DOMAINDATASOURCE> <DATAC:DATAGRID ItemsSource="{Binding Data,Elementname=source}" /> </GRID>

分组
DomainDataSource提供了GroupDescriptors集合来通过属性值来简化分组数据。在GroupDescriptors集合中，我们提供GroupDescriptor示例来定义用来分组的值。可以添加多个GroupDescriptors实例。

1 2 3 4 5 6 7 8 9 10 11 12 13 <GRID x:name="LayoutRoot" Background="White"> <RIACONTRolS:DOMAINDATASOURCE x:name="source" autoLoad="true" queryname="GetProducts"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT /> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <RIACONTRolS:DOMAINDATASOURCE.GROUPDESCRIPTORS> <RIADATA:GROUPDESCRIPTOR PropertyPath="Size" /> </RIACONTRolS:DOMAINDATASOURCE.GROUPDESCRIPTORS> </RIACONTRolS:DOMAINDATASOURCE> <DATAC:DATAGRID ItemsSource="{Binding Data,Elementname=source}" /> </GRID>

过滤
DomainDataSource控件提供FilterDescriptors集合来允许我们过滤查询返回的数据。通过添加过滤，我们可以指定只装载满足条件的域上下文实体。在FIlterDescriptorCollection对象上设置LogicalOperator属性，我们可以在不同的过滤之间定义逻辑关系。
过滤描述符通过FilterOperator枚举器来支持 *** 作。
当定义基于用户输入的过滤时，我们可以提供ControlParameter实例。下面的示例演示了两个通过逻辑AND连接的过滤描述符。一个过滤依赖于用户的输入，另一个过滤通过声明性语句来指定。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 @H_419_1393@ 26 27 28 29 30 <GRID x:name="LayoutRoot" Background="White"> <GRID.ROWDEFinitioNS> <ROWDEFinitioN Height="25" /> <ROWDEFinitioN Height="auto" /> </GRID.ROWDEFinitioNS> <RIACONTRolS:DOMAINDATASOURCE x:name="source" autoLoad="true" queryname="GetProducts"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT /> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <RIACONTRolS:DOMAINDATASOURCE.FILTERDESCRIPTORS> <RIADATA:FILTERDESCRIPTORColLECTION LogicalOperator="And"> <RIADATA:FILTERDESCRIPTOR Value="Blue" PropertyPath="color" Operator="IsEqualTo" /> <RIADATA:FILTERDESCRIPTOR PropertyPath="ListPrice" Operator="IsLessthanorEqualTo"> <RIACONTRolS:CONTRolParaMETER Controlname="MaxPrice" Propertyname="SelectedItem.Content" RefreshEventname="SelectionChanged" /> </RIADATA:FILTERDESCRIPTOR> </RIADATA:FILTERDESCRIPTORColLECTION> </RIACONTRolS:DOMAINDATASOURCE.FILTERDESCRIPTORS> </RIACONTRolS:DOMAINDATASOURCE> <COMBOBox x:name="MaxPrice" GrID.Row="0" WIDth="60" Selectedindex="0"> <COMBOBoxITEM Content="100" /> <COMBOBoxITEM Content="500" /> <COMBOBoxITEM Content="1000" /> @H_419_1393@ </COMBOBox> <DATAC:DATAGRID GrID.Row="1" ItemsSource="{Binding Data,Elementname=source}" /> </GRID>

分页
当显示大量实体的时候，我们会希望在用户界面上提供分页功能。DomainDataSource控件允许我们指定在一个页面上装载和显现的实体数量。新纪录只有在用户导航到了还没有装载实体的页面时才装载。我们设置PageSize和LoadSize属性来指定分页的参数。然后，我们把一个DataPage实例绑定到DomainDataSource来实施分页的接口。
注意：如果在应用程序中DataPager与实体框架数据存贮一起使用，我们必须对为DataPager从查询返回的数据进行排序。因为实体框架不支持没有OrderBy子句或在SL客户端没指定排序的分页。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 <GRID x:name="LayoutRoot" Background="White"> <GRID.ROWDEFinitioNS> <ROWDEFinitioN Height="auto" /> <ROWDEFinitioN Height="auto" /> </GRID.ROWDEFinitioNS> <RIACONTRolS:DOMAINDATASOURCE x:name="source" LoadSize="30" PageSize="15" autoLoad="true" queryname="GetProducts"> <RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <DOMAIN:PRODUCTDOMAINCONTEXT /> </RIACONTRolS:DOMAINDATASOURCE.DOMAINCONTEXT> <RIACONTRolS:DOMAINDATASOURCE.soRTDESCRIPTORS> <RIADATA:SORTDESCRIPTOR PropertyPath="ListPrice" /> </RIACONTRolS:DOMAINDATASOURCE.soRTDESCRIPTORS> </RIACONTRolS:DOMAINDATASOURCE> <DATAC:DATAGRID GrID.Row="0" ItemsSource="{Binding Data,Elementname=source}" /> <DATAC:DATAPAGER GrID.Row="1" Source="{Binding Data,Elementname=source}" /> </GRID>