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: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
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" /> </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> |
编辑
进行数据更改,需要调用DomainDataSource对象的SubmitChanges方法。要取消更改,调用RejectChanges方法。