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

DomainDataSource

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

为了使用DomainDataSource控件，我们必
须在包含DomainDataSource的SL控件中添加一个程序集的引用和命名空间。

在SL项目中,我们必须添加一个对
System.Windows.Controls.Ria程序集的引用。如果选择DataGrid与DomainDataSource一起使用，我们还要
添加对System.Windows.Controls.Data的引用。

在宿主控件内，例如UserControl，我们必须添加下面的命名空
间引用：

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控件，还需添加下面的命名空间：

xmlns:data="clr-namespace:System.Windows.Controls;assembly=System.Windows.Controls.Data"

检索和显示数据

我们为DomainDataSource指定一个域上下文，并向用户提供方法的名字来装载数

据。然后我们绑定表示控件，例如DataGrid对DomainDataSource。下面的例子演示了DomainDataSource检索从名为

ProductDomainContext的域上下文而来的数据。在域服务中应该存在一个名为GetProduct()的查询方法。

<usercontrol 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" queryname="GetProducts" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
</riacontrols:domaindatasource.domaincontext>
</riacontrols:domaindatasource>
<datac:datagrid itemssource="{Binding Data, ElementName=source}">
</datac:datagrid>
</grid>
</usercontrol>


对查询添加参数

某些情况下，查询方法需要参数值。通常，一个查询方法需要一个参数值来过滤返回的数据。下面的

示例演示如何添加参数值，这个值可通过声明性文本来指定。
<grid x:name="LayoutRoot" background="White">
<riacontrols:domaindatasource x:name="source" queryname="GetProductsByColor" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
<riacontrols:domaindatasource.queryparameters>
<riadata:parameter parametername="color" value="Black">
</riadata:parameter>
</riacontrols:domaindatasource.queryparameters>
<datac:datagrid itemssource="{Binding Data, ElementName=source}">
</datac:datagrid>
</riacontrols:domaindatasource.domaincontext></riacontrols:domaindatasource></grid>


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

来自下拉菜单中的值做为参数值。

<grid x:name="LayoutRoot" background="White">
<grid.rowdefinitions>
<rowdefinition height="25">
<rowdefinition height="Auto">
</rowdefinition>
<riacontrols:domaindatasource x:name="source" queryname="GetProductsByColor" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
<riacontrols:domaindatasource.queryparameters>
<riacontrols:controlparameter>
ParameterName="color"
ControlName="colorCombo"
PropertyName="SelectedItem.Content"
RefreshEventName="SelectionChanged" />
</riacontrols:controlparameter>
</riacontrols:domaindatasource.queryparameters>
<combobox width="60" grid.row="0" x:name="colorCombo">
<comboboxitem content="Black">
<comboboxitem content="Blue">
</comboboxitem>
<datac:datagrid grid.row="1" itemssource="{Binding Data, ElementName=source}">
</datac:datagrid>
</comboboxitem></combobox></riacontrols:domaindatasource.domaincontext></riacontrols:domaindatasource></rowdefinition></grid.rowdefinitions></grid>


排序

DomainDataSource提供SortDescriptors集合来简化数据的排序。在

SortDescriptors集合中，我们提供SortDescriptor实例来向用户描述参数值。我们可以添加多个SortDescriptor实

例。还可以指定数据排序的升降序。下面的示例演示DomainDataSource中的排序描述符，从查询中检索的数据按来自StandardPrice
<grid x:name="LayoutRoot" background="White">
<riacontrols:domaindatasource x:name="source" queryname="GetProducts" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
<riacontrols:domaindatasource.sortdescriptors>
<riadata:sortdescriptor propertypath="StandardCost" direction="Ascending">
</riadata:sortdescriptor>
</riacontrols:domaindatasource.sortdescriptors>
<datac:datagrid itemssource="{Binding Data, ElementName=source}">
</datac:datagrid>
</riacontrols:domaindatasource.domaincontext></riacontrols:domaindatasource></grid>


分组

DomainDataSource提供了GroupDescriptors集合来通过属性值来简化分组数

据。在GroupDescriptors集合中，我们提供GroupDescriptor示例来定义用来分组的值。可以添加多个

<grid x:name="LayoutRoot" background="White">
<riacontrols:domaindatasource x:name="source" queryname="GetProducts" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
<riacontrols:domaindatasource.groupdescriptors>
<riadata:groupdescriptor propertypath="Size">
</riadata:groupdescriptor>
</riacontrols:domaindatasource.groupdescriptors>
<datac:datagrid itemssource="{Binding Data, ElementName=source}">
</datac:datagrid>
</riacontrols:domaindatasource.domaincontext></riacontrols:domaindatasource></grid>


过滤

DomainDataSource控件提供FilterDescriptors集合来允许我们过滤查询返

回的数据。通过添加过滤，我们可以指定只装载满足条件的域上下文实体。在FIlterDescriptorCollection对象上设置

LogicalOperator属性，我们可以在不同的过滤之间定义逻辑关系。

过滤描述符通过FilterOperator枚举器来支持操作。

当

定义基于用户输入的过滤时，我们可以提供ControlParameter实例。下面的示例演示了两个通过逻辑AND连接的过滤描述符。一个过滤依赖于用

户的输入，另一个过滤通过声明性语句来指定。

<grid x:name="LayoutRoot" background="White">
<grid.rowdefinitions>
<rowdefinition height="25">
<rowdefinition height="Auto">
</rowdefinition>
<riacontrols:domaindatasource x:name="source" queryname="GetProducts" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
<riacontrols:domaindatasource.filterdescriptors>
<riadata:filterdescriptorcollection logicaloperator="And">
<riadata:filterdescriptor propertypath="Color" operator="IsEqualTo" value="Blue">
<riadata:filterdescriptor propertypath="ListPrice" operator="IsLessThanOrEqualTo">
<riacontrols:controlparameter>
ControlName="MaxPrice"
PropertyName="SelectedItem.Content"
RefreshEventName="SelectionChanged" />
</riacontrols:controlparameter>
</riadata:filterdescriptor>
</riadata:filterdescriptor>
</riadata:filterdescriptorcollection>
<combobox x:name="MaxPrice" grid.row="0" width="60" selectedindex="0">
<comboboxitem content="100">
<comboboxitem content="500">
<comboboxitem content="1000">
</comboboxitem>
<datac:datagrid grid.row="1" itemssource="{Binding Data, ElementName=source}">
</datac:datagrid>


分页

当显示大量实体的时候，我们会希望在用户界面上提供分页功能。DomainDataSource

控件允许我们指定在一个页面上装载和显现的实体数量。新纪录只有在用户导航到了还没有装载实体的页面时才装载。我们设置PageSize和

LoadSize属性来指定分页的参数。然后，我们把一个DataPage实例绑定到DomainDataSource来实施分页的接口。

注意：

如果在应用程序中DataPager与实体框架数据存贮一起使用，我们必须对为DataPager从查询返回的数据进行排序。因为实体框架不支持没有
<grid x:name="LayoutRoot" background="White">
<grid.rowdefinitions>
<rowdefinition height="Auto">
<rowdefinition height="Auto">
</rowdefinition>
<riacontrols:domaindatasource pagesize="15" loadsize="30" x:name="source" queryname="GetProducts" autoload="true">
<riacontrols:domaindatasource.domaincontext>
<domain:productdomaincontext>
</domain:productdomaincontext>
<riacontrols:domaindatasource.sortdescriptors>
<riadata:sortdescriptor propertypath="ListPrice">
</riadata:sortdescriptor>
</riacontrols:domaindatasource.sortdescriptors>
<datac:datagrid grid.row="0" itemssource="{Binding Data, ElementName=source}">
<datac:datapager grid.row="1" source="{Binding Data, ElementName=source}">
</datac:datapager>
</datac:datagrid></riacontrols:domaindatasource.domaincontext></riacontrols:domaindatasource></rowdefinition></grid.rowdefinitions></grid>


编辑

进行数据更改，需要调用DomainDataSource对象的SubmitChanges方

法。要取消更改，调用RejectChanges方法。