在上一章的教程中,我们看了GridView、DetailsView和FormView绑定到OjbectDataSource控件显示数据,ObjectDataSource调用了类ProductsBLL的GetProducts()方法。方法GetProducts()返回一个有Northwind数据库的Products表的所有记录组成的强类型数据表。类ProductsBLL还包含了其它返回部分数据的方法:GetProductByProductID(productID),GetProductsByCategoryID(categoryID), 和 GetProductsBySupplierID(supplierID) 。这三个方法要求输入一个参数来指示如何筛选返回的产品信息数据。
ObjectDataSource可以调用需要传入参数的方法,不过为了实现这一点,我们需要指定这些参数从哪里获取值。这些参数的值可以通过硬代码传入,也可以从某类来源动态地获取,包括:查询字符串的值(QueryString),会话变量(Session variables),页面上控件的属性值,或者其它。
在这一章的教程里,让我们开始举例说明如何使用参数设置一个硬编码的值。特别地,我们将着眼于添加一个DetailsView到页面来显示一个名为Chef Anton's Gumbo Mix的特殊产品,它的ProductID是5 。下一步,我们将看看如何基于Web控件设置参数的值。特别地,我们将使用一个TextBox让用户键入国家(country),在点击某个按钮后列出驻该国家的供应商。
使用一个硬编码参数值
第一个例子,首先添加一DetailsView控件到BasicReporting文件夹里的DeclarativeParams.aspx页面。从DetailsView控件的智能标记的下拉列表中选择<新建数据源…>,然后选择添加一个ObjectDataSource 。
图 1: 添加一个ObjectDataSource到页面
这将自动打开ObjectDataSource控件的配置数据源导航。在第一屏的导航中选择类ProductsBLL 。
图 2: 选择类ProductsBLL
既然我们要显示一个特定的产品的信息,我们应该使用GetProductByProductID(productID)方法。
图 3: 选择GetProductByProductID(productID) 方法
因为我们选择了这个包含参数的方法,导航就多了一屏,在这一屏要求我们定义参数所用的值。在左边的列表中显示我们指定方法的所有参数。对于GetProductByProductID(productID)方法则只有一个参数:productID 。在右边的参数源下拉列表中列举出有可能被作为参数源的几类参数值。既然我们要指定一个硬编码的值5用作productID参数,就让参数源选项是None并在DefaultValue输入框键入5 。
图 4: 参数productID使用硬编码的值
完成了配置数据源向导后,ObjectDataSource控件的声明标记里就包含了一个SelectParameters集合,每一个SelectMethod属性里指定的方法的参数都对应一个Parameter对象。既然我们这个例子中的方法只要求一个参数parameterID ,那么SelectParameters集合里也就只有一个元素。SelectParameters集合可以包含任何来源于System.Web.UI.WebControls命名空间的类。因为是硬编码参数值所以使用基本的Parameter类;如果需要的话你也可以创建自定义参数类型(custom parameter types)。
<asp:ObjectDataSource runat="server" SelectMethod="GetProductByProductID" TypeName="ProductsBLL"> <SelectParameters> <asp:Parameter DefaultValue="5" Type="Int32" /> </SelectParameters> </asp:ObjectDataSource>
注意:如果你在自己的电脑上跟随这些步骤声明标记,你可能会看见这里包含InsertMethod,UpdateMethod和 DeleteMethod 的参数值,比如DeleteParameters 。ObjectDataSource的选择数据源向导自动地指定了这些ProductBLL的方法从而实现插入、更新和删除,因此,除非你明确地清除它们,否则它们将包含在上面的标记里。
当访问本页面,Data Web服务器控件将调用ObjectDataSource的Select方法,这将调用类ProductsBLL的GetProductByProductID(productID),并使用“5”这个硬编码的值作为输入参数productID 。此方法将返回一个强类型的ProductDataTable对象,它包含一个数据行 - Chef Anton's Gumbo Mix的信息(ProductID为5的产品)。
图 5: 显示Chef Anton's Gumbo Mix的相关信息
设置Web控件的属性作为参数源