WCF RIA 服务 （九）- Domain Service 2

WCF RIA 服务 （九）- Domain Service 2

演练：添加查询方法
查询数据源的方法有时被叫做查询方法。在WCF RIA Services中，查询方法必须以框架承认的方式来定义。此外，只返回一个实体的查询和有可能返回多个实体的查询定义是不同的。
当我们建立一个 新的domain service类并在Add New Domain Service Class 对话框中指定实体时，RIA Services框架会自动为每一个服务端公开的实体创建一个简单的查询。这个简单的查询方法检索实体的所有数据。这个演练将描述如何添加一个用参数值来 过滤结果的复杂查询方法。还描述了如何添加一个返回单个实体和一个实体集合的查询。
添加一个接受参数并返回单一实体的查询方法

1. 打 开我们中创建的RIAServicesExample解决方案。
2. 
   
3. 在服务端，打开从Customer表公开数据的 domain Services 类。这个类应该叫做CustmerDomainService。
4. 
   
5. 添加一个查询方法，这个方法 接受一个整数类型的参数并返回符合Customer ID的Customer实体。 如果返回单一实体的方法包含Query属性，必须设置IsComposable为false. 用户不能从客户端指定其他的查询操作。如果这个查询方法满足了作为查询所期望的签名，我们就不必使用[Query]属性。返回值必须是任何实体对象的单一 实例。
   
   [Query(IsComposable=false)] public Customer GetCustomersByID(int customerID) { return this.ObjectContext.Customers.FirstOrDefault(c => c.CustomerID == customerID); } 

添 加一个接受一个参数并返回一个实体集合的查询方法

1. 打开从Customer表公开数据的domain service类。名字应为CustomerDomainService。
2. 
   
3. 添加一个方法，这个方法接受一个字符型参数并返回所 有名字以参数开始的客户。这个方法可以返回一个IQueryable<>对象，因为用户可能想从客户端提供额外的查询。
   
   public IQueryable<customer> GetCustomersByLastNameLetter(string startingLastNameLetter) { return this.ObjectContext.Customers.Where(c => c.LastName.StartsWith(startingLastNameLetter) == true); }

在 客户端显示这些查询的结果

1. 在客户端打开MainPage.xaml文件。
2. 
   
3. 添 加两个TextBox控件和两个Button控件，这样用过就可以通过ID或名的首字母来过滤。下面的xaml代码显示了DataGrid的完整布局。
   
   <usercontrol class="RIAServicesExample.MainPage" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" designheight="300" designwidth="400" ignorable="d" mc="http://schemas.openxmlformats.org/markup-compatibility/2006" d="http://schemas.microsoft.com/expression/blend/2008" x="http://schemas.microsoft.com/winfx/2006/xaml" data="clr-namespace:System.Windows.Controls;assembly=System.Windows.Controls.Data"> <grid name="LayoutRoot" background="White"> <grid.columndefinitions> <columndefinition></columndefinition> <columndefinition></columndefinition> </grid.columndefinitions> <grid.rowdefinitions> <rowdefinition height="25"></rowdefinition> <rowdefinition></rowdefinition> </grid.rowdefinitions> <stackpanel orientation="Horizontal" row="0" column="0"> <textblock text="search by id: "></textblock> <textbox name="IDValue" width="50"></textbox> <button name="IDButton" content="Submit" click="IDButton_Click"></button> </stackpanel> <stackpanel orientation="Horizontal" row="0" column="1"> <textblock text="search by name: "></textblock> <textbox name="LetterValue" width="30"></textbox> <button name="LetterButton" content="Submit" click="LetterButton_Click"></button> </stackpanel> <data:datagrid name="CustomerGrid" row="1" column="0" columnspan="2"></data:datagrid> </grid> </usercontrol>
   
4. 
   
5. 打 开MainPage.xaml的代码文件。
6. 
   
   
7. 添加代码来根据用户的输入来检索数据。
   
   [Query(IsComposable=false)] public Customer GetCustomersByID(int customerID) { return this.ObjectContext.Customers.FirstOrDefault(c => c.CustomerID == customerID); }

8. 
   
   
9. 运 行解决方案。将会看到如下结果