在 ASP.NET 2.0 中操作數據 :: 編程設置 ObjectDataSource 的參數值

下載本教程中的編碼例子 | 下載本教程的PDF版

導言

正如我們在上一節的教程中所看到的，有很多可供選擇的方式把參數的值傳遞到 OjbectDataSource 的方法里。假如參數值是采用硬編碼方式，來源于頁面上的一個 Web 控件，又或者其他可被數據源 Parameter 對象讀取的源，那么這個值可以綁定到輸入參數而不需要寫一行的代碼。

然而有些時候，參數值來自某些在數據源的內置 Parameter 對象里還沒有計算出來的源。假如我們的站點支持我們的考慮那么我們也許希望參數基于當前登錄用戶。又或者我們在參數傳送到 ObjectDataSource 的隱含對象的方法前做一些客戶化定制。

無論什么時候調用 ObjectDataSource 的 Seelect 方法，它都會首先觸發它的 Selecting 事件，然后才調用 ObjectDataSource 的隱含對象的方法，完成后則激發 ObjectDataSource ObjectDataSource 的 Selected 事件（圖一說明這些事件的順序）。可以在 Selecting 事件的 事件委托中對參數的值進行設置或更改。

圖 1: ObjectDataSource 的 Selected 和 Selecting 事件分別在調用它的隱含對象的方法之前和之后觸發

這一節里我們將看看添加一個接受一個輸入參數方法到 DAL 和 BLL 層，參數名為 Month ， int 類型，方法返回一個 EmployeesDataTable 對象，里邊包含的是雇傭周年紀念都指定月份的雇員。我們的例子將編碼設置為基于當前月份，顯示一個“本月雇用周年紀念員工”列表。

讓我們開始吧！

第一步 : 添加一個方法到 EmployeesTableAdapter

在我們的第一個例子里，我們需要添加一個方法來獲取那些雇用日期（ HireDate ）在某個指定月份的員工。在我們的程序架構下為了提供這個功能，我們首先需要在通過特定 SQL 語句映射出來的 EmployeesTableAdapter 中創建一個方法。為了實現這一點，首先打開 Northwind 類型化數據集，在 EmployeesTableAdapter 標簽上右鍵選擇“添加查詢”。

圖 2: 在 EmployeesTableAdapter 里添加一個查詢

選擇返回一個或多個行和列的 SQL 語句。當到達指定 SELECT 語句窗口時， EmployeesTableAdapter 已經裝載了默認的 SELECT 語句。簡單地，添加一個 WHERE 子句： WHERE DATEPART(m, HireDate) = @Month 。其中 DATEPART 是 T-SQL 里的一個函數，用作返回日期類型的一部分；在這里，我們使用 DATEPART 函數返回雇用日期（ HireDate ）列的月份部分。

圖 3: 僅返回 HireDate 列的值小于等于參數 @HiredBeforeDate 的行

最后，分別把默認的方法名 FillBy 和 GetDataBy 更改為 FillByHiredDateMonth 和 GetEmployeesByHiredDateMonth 。

圖 4: 選擇比 FillBy 和 GetDataBy 更恰當的方法名稱

點擊“完成”結束向導并返回到數據集的設計界面。這時候 EmployeesTableAdapter 會包含一套新的方法來獲取指定月份雇用的員工。

圖 5: 新的方法出現在數據集的設計界面

第二步 : 在業務邏輯層添加方法 GetEmployeesByHiredDateMonth( month )

因為我們的程序架構使用了單獨的一層來處理業務邏輯和數據邏輯，我們需要在 BLL 里增加一個方法，該方法調用 DAL 的方法獲取指定月份里雇用的員工。打開文件 EmployeesBLL.cs 并添加下面這個方法：

[System.ComponentModel.DataObjectMethodAttribute(System.ComponentModel.DataObjectMethodType.Select, false)]

public Northwind.EmployeesDataTable GetEmployeesByHiredDateMonth(int month)

{

return Adapter.GetEmployeesByHiredDateMonth(month);

}

和此類里的其他方法一樣， GetEmployeesByHiredDateMonth( month ) 僅僅是簡單地調用 DAL 并返回結果。

第三步 : 顯示雇用周年紀念日在本月份的員工

最后一部我們舉例說明如何顯示雇用周年紀念在本月份的員工。首先，添加一個 GridView 控件到頁面 ProgrammaticParams.aspx ，該頁面在文件夾 BasicReporting 里。添加一個新的 ObjectDataSource 控件作為它的數據源。配置 ObjectDataSource 使用類 EmployeesBLL 并指定 SelectMethod 屬性為 GetEmployeesByHiredDateMonth( month ) 。

圖 6: 使用 EmployeesBLL 類

圖 7: 選擇 GetEmployeesByHiredDateMonth( month ) 方法

最后一屏要求我們給 month 參數提供參數源。既然我們將編碼設置這個值，就讓參數源維持它的默認選項 None ，點擊“完成”。

圖 8: 讓參數源設置為 None

這將在 ObjectDataSource 的 SelectParameters 集合里創建一個未指定參數值的 Parameter 對象。

<asp:ObjectDataSource ID="ObjectDataSource1" runat="server" OldValuesParameterFormatString="original_{0}"

SelectMethod="GetEmployeesByHiredDateMonth" TypeName="EmployeesBLL">

<SelectParameters>

<asp:Parameter Name="month" Type="Int32" />

</SelectParameters>

</asp:ObjectDataSource>

要編碼設置這個參數值，我們需要給 ObjectDataSource 的 Selecting 事件添加一個事件委托。為了實現這一點，到設計視圖里在 ObjectDataSource 上雙擊。另一種方式是選中 ObjectDataSource 在屬性窗口里點擊黃色閃電小圖標，然后，直接在 Selecting 這一欄里雙擊或者輸入一個你要使用的事件委托的名稱。

圖 9: 點擊屬性窗口里的閃電圖標列出 Web 控件的所有事件

兩種途徑都可以在頁面的 代碼隱藏類 里增加一個對 ObjectDataSourc e 的 Selecting 事件的事件委托。在這個事件委托里，我們可以通過使用 e.InputParameters[ parameterName ] 讀取參數的值，其中 parameterName 的值是 <asp:Parameter> 標簽里的屬性 Name 的值（ InputParameters 也可以按照索引訪問，用 e.InputParameters[ index ] ）。為了把 month 參數設置為當前月份，需要在 Selecting 事件委托里加入如下代碼：

protected void ObjectDataSource1_Selecting(object sender, ObjectDataSourceSelectingEventArgs e)

{

e.InputParameters["month"] = DateTime.Now.Month;

}

當通過瀏覽器訪問該頁面，我們可以看到只有一個員工是在當前月份（三月）雇用的： Laura Callahan ，他從 1994 年 3 月開始雇用。

圖 10: 雇用周年紀念日在本月份的員工被顯示出來了

總結

雖然可以用特定的方式聲明 ObjectDataSource 的參數值而不需要寫代碼，編程設置參數值同樣很容易。我們需要做的僅僅是給 ObjectDataSource 的 Selecting 事件增加一個事件委托，它在調用隱含對象的方式前觸發，并且通過 InputParameters 集合 手工設置一個或多個參數值。

本節結束 基本 這一章。下一節我們開始 主從數據 一章，這一章里我們將著眼于允許訪問者篩選數據和主從數據處理的技巧。

祝編程快樂！

作者簡介

Scott Mitchell ，著有六本 ASP/ASP.NET 方面的書，是 4GuysFromRolla.com 的創始人，自 1998 年以來一直應用微軟 Web 技術。 Scott 是個獨立的技 術咨詢顧問，培訓師，作家，最近完成了將由 Sams 出版社出版的新作， 24 小時內精通 ASP.NET 2.0 。他的聯系電郵為 mitchell@4guysfromrolla.com ，也可以通過他的博客 http://ScottOnWriting.NET 與他聯系。