OjbectDataSource控件的参数值也可以设置为基于页面上的Web控件的值。为了说明这一点,我们举一个使用GridView来显示位于用户指定的国家的供应商的例子。首先,在页面上添加一个TextBox控件让用户输入国家名称。这个TextBox控件的ID属性设为CountryName 。再添加一个按钮控件到页面。
图 6: 添加一个ID为CountryName的TextBox控件到页面
Next, add a GridView to the page and, from the smart tag, choose to add a new ObjectDataSource. Since we want to display supplier information select the SuppliersBLL class from the wizard's first screen. From the second screen, pick the GetSuppliersByCountry(country) method.
然后,添加一个GridView控件到页面,从它的智能标记,选择添加一个新的ObjectDataSource 。因为我们要显示供应商信息,所以在配置数据源向导第一屏选择类SuppliersBLL 。第二屏,选择GetSuppliersByCountry(country)方法。
图 7: 选择GetSuppliersByCountry(country) 方法
因为GetSuppliersByCountry(country)方法有一个输入参数,所以向导再次显示最后一屏,让你选择参数的值。这一次,设置参数源为Control,这时会出现一个ControlID下拉列表,列表中包含页面上所有控件的名称;从中选择CountryName控件。由于第一次访问本页面时文本框CountryName会为空白,那么就没有值从它返回,也就不显示任何数据。如果你希望默认显示一些结果,那么要在DefaultValue文本框里输入一个默认的参数值。
图 8: 设置CountryName控件的值作为参数值
ObjectDataSource的声明标记跟我们的第一个例子会稍有不同。使用一个 ControlParameter替代了标准的Parameter对象。ControlParameter具有一些额外的属性用来指定Web控件的ID,还有用作参数的属性值(PropertyName)。配置数据源向导足以帮我们决定,例如TextBox,我们很有可能会使用它的Text属性作为参数值。然而,如果你需要使用Web控件的一个不同的属性值,那么你需要在这里更改PropertyName属性,或者从配置数据源向导里点击“高级属性”。
<asp:ObjectDataSource runat="server" SelectMethod="GetSuppliersByCountry" TypeName="SuppliersBLL"> <SelectParameters> <asp:ControlParameter ControlID="CountryName" PropertyName="Text" Type="String" /> </SelectParameters> </asp:ObjectDataSource>
当第一次访问该页面时,文本框CountryName里的内容是空白的。GridView控件仍然会调用ObjectDataSource的Select方法,但是,一个空值会被传入GetSuppliersByCountry(country)方法。表适配器(TableAdapter)会将这个null值转换成数据库里的NULL值(DBNull.Value),然而GetSuppliersByCountry(country)方法所使用的查询已经写明在传入一个NULL值错位参数@CategoryID时将不会返回任何结果。简而言之,不会返回任何供应商。
一旦访问正输入一个国家,然后点击Show Suppliers按钮触发一次回传(postback),ObjectDataSource的Select方法被请求,同时传递文本框的Text值作为country参数。
图 9: 显示出位于Canada的供应商
默认显示所有供应商
相对于在第一次访问页面时不显示任何供应商,我们也许会希望一开始显示所有的供应商,并且允许用户通过在文本框里输入国家名称来缩减列表。当文本框空白时,一个null值被传递到类SuppliersBLL的GetSuppliersByCountry(country)方法作为country输入参数。这个null值继续被传递到DAL层的GetSupplierByCountry(country)方法,在那里它会被转换成数据库里的NULL值用作下面这个查询的@Country参数:
SELECT SupplierID, CompanyName, Address, City, Country, Phone FROM Suppliers WHERE Country = @Country
表达式Country = NULL总是返回False,除非有某些记录Country字段的值恰好为NULL,否则不返回任何数据。