導言：

　　當向類型化的數(shù)據(jù)集(Typed DataSet)添加一個TableAdapter時，相應的DataTable的構架已經(jīng)由TableAdapter的主查詢定義好了.比如，如果主查詢返回A, B,C這3個域，那么 DataTable將有對應的3個列A, B,和C.除了主查詢以外，TableAdapter還可以包含其他的查詢，可能是返回基于某些參數(shù)的數(shù)據(jù)。比如，ProductsTableAdapter的主查詢返回所有產(chǎn)品的信息，此外，ProductsTableAdapter還包含諸如GetProductsByCategoryID(categoryID) 和 GetProductByProductID(productID)的方法，它們根據(jù)指派的參數(shù)返回特定的產(chǎn)品信息.

　　如果TableAdapter的方法返回的列涵蓋在主查詢里，工作起來沒有問題。但如果返回的列并沒有涵蓋在主查詢，那么我們就需要對DataTable的構架進行擴充.在第35章《使用Repeater和DataList單頁面實現(xiàn)主/從報表》里，我們向CategoriesTableAdapter添加方法以返回 CategoryID, CategoryName, Description和NumberOfProducts列。其中前3列是涵蓋在主查詢里的，而NumberOfProducts列沒有在主查詢里定義，它返回的是每個category相關產(chǎn)品的數(shù)目.我們可以向CategoriesDataTable手工添加一列，以便于統(tǒng)計從新方法返回的NumberOfProducts列的值.

　　在第52章《使用FileUpload上傳文件》我們探討過，對使用ad-hoc SQL statements構建且其方法返回的列超出主查詢范圍的TableAdapters必須多加留意.因為一旦重新運行設置向?qū)У脑?，它將對TableAdapter的方法進行更新，使其返回的列與主查詢相匹配.不過如果使用存儲過程的話就不會出現(xiàn)這種情況.

　　在本文我們將考察如何擴展DataTable的構架以包含額外的列。我們都知道使用ad-hoc SQL statements構架的TableAdapter不穩(wěn)定，本文我們將用存儲過程來構架.你可以參考第65章《在TableAdapters中創(chuàng)建新的存儲過程》和第66章《在TableAdapters中使用現(xiàn)有的存儲過程》來獲取設置TableAdapter使用存儲過程的更多信息.

第一步：向ProductsDataTable添加一個PriceQuartile列

　　在第67章里我們創(chuàng)建了一個名為NorthwindWithSprocs的類型化的數(shù)據(jù)集.該數(shù)據(jù)集目前包含2個DataTables：ProductsDataTable以及 EmployeesDataTable。其中ProductsTableAdapter包含3個方法：

.GetProducts——主查詢，返回Products表的所有記錄
.GetProductsByCategoryID(categoryID)——根據(jù)指定的categoryID值返回所有產(chǎn)品
.GetProductByProductID(productID)——根據(jù)指定的productID值返回所有的產(chǎn)品

　　主查詢及另外2個方法都返回相同的數(shù)據(jù)列，也就是Products表的所有列，并沒有返回Categories 以及Suppliers表的相關數(shù)據(jù).

　　在本文，我們將向ProductsTableAdapter添加一個名為GetProductsWithPriceQuartile 的方法，它返回所有的產(chǎn)品.除了標準的數(shù)據(jù)列外，它還返回PriceQuartile列，它用四分位數(shù)來衡量產(chǎn)品價格下跌程度.如果產(chǎn)品價格上升了25%，那么其值為1，如果下降為25%，那么其值為4.在我們創(chuàng)建一個存儲過程來返回這種信息之前，我們首先需要更新ProductsDataTable，新添一列來包含GetProductsWithPriceQuartile方法返回的 PriceQuartile值.

　　打開NorthwindWithSprocs數(shù)據(jù)集，在ProductsDataTable上右鍵單擊，選擇“ Add” ，再選擇“Column”.

圖1：向ProductsDataTable新添一列

　　這將向DataTable新添一列，名為“Column1”，類型為System.String.我們需要將該列的名稱改為“PriceQuartile”，類型改為System.Int32，因為它的值介于1到4之間.在ProductsDataTable 選中我們新添加的列，在屬性窗口里設置其Name屬性為 “PriceQuartile”，DataType屬性為System.Int32.

圖2：設置該新列的Name 和 DataType屬性

　　就像圖2所示，我們還可以設置其它的屬性.比如，是否該列的值必須為unique；如果該列為自增列，其值是否允許為NULL等等.不過我們這里使用其默認值.

第二步：創(chuàng)建GetProductsWithPriceQuartile方法

　　現(xiàn)在我們已經(jīng)對ProductsDataTable進行了更新以包含PriceQuartile列，我們將要創(chuàng)建一個GetProductsWithPriceQuartile方法.在TableAdapter上單擊右鍵，再選擇“Add Query”.這將開啟TableAdapter查詢設置向?qū)?，它首先詢問我們是使用ad-hoc SQL statements還是使用現(xiàn)有的存儲過程或新建一個存儲過程.我們選擇“Create new stored procedure”，再點Next.

圖3：在TableAdapter向?qū)Ю飫?chuàng)建新的存儲過程

　　接下來，如圖4所示，向?qū)г儐栁覀兲砑拥氖悄欠N類型的查詢，由于GetProductsWithPriceQuartile方法將返回Products表的所有記錄以及所有列，我們選擇“SELECT which returns rows”項，再點Next.

圖4：查詢將是一個返回多個行的SELECT Statement

接下來，我們在向?qū)Ю镦I入如下的查詢：

SELECT ProductID, ProductName, SupplierID, CategoryID,
 QuantityPerUnit, UnitPrice, UnitsInStock, UnitsOnOrder,
 ReorderLevel, Discontinued,
 NTILE(4) OVER (ORDER BY UnitPrice DESC) as PriceQuartile
FROM Products

　　上述查詢使用了SQL Server 2005新增的NTILE function函數(shù)，它將結果劃分為4組，將UnitPrice值按降序分組.

　　不幸的是，查詢構造器(Query Builder)不能解析關鍵字OVER，并拋出一個錯誤信息。因此，直接在向?qū)У奈谋究蚶镦I入上述代碼，而不要使用查詢構造器.

　　注意：關于NTILE以及SQL Server 2005的其它函數(shù)的更多信息，你可參閱文章《Returning Ranked Results with Microsoft SQL Server 2005》（http://www.4guysfromrolla.com/webtech/010406-1.shtml)以及SQL Server 2005 Books Online的《Ranking Functions section》部分(http://msdn2.microsoft.com/en-us/library/ms189798.aspx)

　　完成后，點Next, 向?qū)⒁覀優(yōu)樾麓鎯^程重命名，我們?nèi)∶麨镻roducts_SelectWithPriceQuartile再點Next.

圖5：將新存儲過程命名為Products_SelectWithPriceQuartile

　　最后我們要為TableAdapter的方法命名，選中“Fill a DataTable” 和 “Return a DataTable”兩項，并重命名為 FillWithPriceQuartile 和GetProductsWithPriceQuartile.

圖6：對TableAdapter的方法命名并點Finish

　　當指定了SELECT查詢，并對存儲過程和TableAdapter的方法命名后，點Finish完成向?qū)?。這時你將看到1到2條警告信息，說“The OVER SQL construct or statement is not supported.” 不必理會它.

　　完成向?qū)Ш?，該TableAdapter將會包含F(xiàn)illWithPriceQuartile 和GetProductsWithPriceQuartile方法，并且數(shù)據(jù)庫將包含一個名為Products_SelectWithPriceQuartile的存儲過程?；c時間來驗證一下，檢查數(shù)據(jù)庫，如果你沒有看到我們剛添加的存儲過程，在存儲過程文件夾上右鍵單擊，選“刷新”.

圖7：驗證新方法是否添加到TableAdapter

圖8：確保數(shù)據(jù)庫包含Products_SelectWithPriceQuartile存儲過程

　　注意：使用存儲過程來替換ad-hoc SQL statements的好處之一是重新運行TableAdapter設置向?qū)У脑挷⒉粫膭哟鎯^程返回的列.我們可以作一個驗證，在TableAdapter上右鍵單擊，選“Configure”項，以啟動向?qū)?，然后點Finish完成向?qū)?。接下來，我們在?shù)據(jù)庫里查看Products_SelectWithPriceQuartile存儲過程.我們注意到其返回的列并沒有發(fā)生變化.如果我們使用的是ad-hoc SQL statements的話，重新運行向?qū)共樵兎祷氐牧信c主查詢的列相匹配，因此它將把GetProductsWithPriceQuartile方法里使用的查詢里的NTILE statement刪除掉.

　　當調(diào)用數(shù)據(jù)訪問層的GetProductsWithPriceQuartile方法時，TableAdapter將執(zhí)Products_SelectWithPriceQuartile存儲過程，并為返回的每條記錄向ProductsDataTable添加對應的row.存儲過程返回的數(shù)據(jù)域(data fields)將映射到ProductsDataTable的列.因為該存儲過程要返回一個PriceQuartile數(shù)據(jù)域，所以它的值將分配給ProductsDataTable的PriceQuartile列.

　　對于那些不返回PriceQuartile數(shù)據(jù)域的方法而言，PriceQuartile列的值由其DefaultValue屬性指定. 如圖2所示，該默認值為DBNull。如果你想指定為其他值，僅僅改動DefaultValue屬性即可，但一定要是一個有效的值(比如，PriceQuartile列的值一定要是一個System.Int32類型的值).

　　現(xiàn)在我們完成了向DataTable添加額外列的必要的步驟，接下來我們要創(chuàng)建一個ASP.NET 頁面來展示每個產(chǎn)品的 name, price,以及price quartile.不過我們要先對業(yè)務邏輯層進行更新，以包含一個方法來調(diào)用數(shù)據(jù)訪問層的GetProductsWithPriceQuartile方法.我們將在第3步更新業(yè)務邏輯層，在第4步創(chuàng)建一個ASP.NET頁面.

第三步：更新業(yè)務邏輯層

　　我們在表現(xiàn)層調(diào)用新添加的GetProductsWithPriceQuartile方法以前，必須在業(yè)務邏輯層添加相應的方法，打開ProductsBLLWithSprocs class類文件，添加如下的代碼：

[System.ComponentModel.DataObjectMethodAttribute
 (System.ComponentModel.DataObjectMethodType.Select, false)]
public NorthwindWithSprocs.ProductsDataTable GetProductsWithPriceQuartile()
{
 return Adapter.GetProductsWithPriceQuartile();
}

　　就像其它方法一樣，GetProductsWithPriceQuartile僅僅調(diào)用數(shù)據(jù)訪問層對應的GetProductsWithPriceQuartile方法并返回其結果.

第四步：在一個ASP.NET頁面展示Price Quartile信息

　　完成對業(yè)務邏輯層的修改后，我們將創(chuàng)建一個ASP.NET頁面來顯示每個產(chǎn)品的price quartile信息.打開AdvancedDAL文件夾里的AddingColumns.aspx頁面，從工具箱拖一個 GridView控件到頁面，設置其ID為Products.在其智能標簽里將其綁定到一個名為ProductsDataSource的新的ObjectDataSource控件，設置該控件調(diào)用ProductsBLLWithSprocs class類的GetProductsWithPriceQuartile方法，在UPDATE, INSERT,和DELETE標簽里選“(None)”.

圖9：設置ObjectDataSource調(diào)用ProductsBLLWithSprocs類

圖10：調(diào)用GetProductsWithPriceQuartile方法獲取產(chǎn)品信息

　　完成設置向?qū)Ш螅?Visual Studio會為GridView添加BoundField或CheckBoxField列，其中包括PriceQuartile列. 將ProductName, UnitPrice,PriceQuartile以外的列全部刪除，設置UnitPrice列為貨幣格式.并將UnitPrice 和 PriceQuartile列放在右邊，居中。 最后分別將這3列的HeaderText屬性設置為“Product”, “Price”,“Price Quartile”。同時啟用GridView控件的排序功能.

　　作上述修改后， GridView 和 ObjectDataSource控件的聲明代碼看起來和下面的差不多：

asp:GridView ID="Products" runat="server" AllowSorting="True"
 AutoGenerateColumns="False" DataKeyNames="ProductID"
 DataSourceID="ProductsDataSource">
 Columns>
 asp:BoundField DataField="ProductName" HeaderText="Product"
  SortExpression="ProductName" />
 asp:BoundField DataField="UnitPrice" DataFormatString="{0:c}"
  HeaderText="Price" HtmlEncode="False"
  SortExpression="UnitPrice">
  ItemStyle HorizontalAlign="Right" />
 /asp:BoundField>
 asp:BoundField DataField="PriceQuartile" HeaderText="Price Quartile"
  SortExpression="PriceQuartile">
  ItemStyle HorizontalAlign="Center" />
 /asp:BoundField>
 /Columns>
/asp:GridView>

asp:ObjectDataSource ID="ProductsDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}"
 SelectMethod="GetProductsWithPriceQuartile"
 TypeName="ProductsBLLWithSprocs">
/asp:ObjectDataSource>

　　如圖11為在瀏覽器里登錄該頁面的情況，我們注意到，最開始產(chǎn)品按price的降序排列，同時每個產(chǎn)品都有相應的PriceQuartile值，當然這些數(shù)據(jù)也可以按其它標準來排序，如圖12所示。

圖11：產(chǎn)品按Prices來排序

圖12：產(chǎn)品按名稱來排序.

　　注意：只需要很少的代碼，我們就可以根據(jù)每行PriceQuartile值的不同而顯示不同的顏色，比如對值為1的行顯示為淺綠色，對值為2的行顯示為淺黃色，以此類推.你可以花點時間來實現(xiàn)該功能，如果有必要的話，你可以參閱第11章《基于數(shù)據(jù)的自定義格式化》

另一種途徑——創(chuàng)建另一個TableAdapter

　　正如我們在本文看到的，當向TableAdapter添加的方法返回的列超出了主查詢范圍的時候，我們可以向DataTable添加相應的列即可.對TableAdapter而言，如果當其包含的返回“額外列”的方法較少且“額外列”不是很多的時候，這種途徑才能正常工作。

　　除了往DataTable添加列以外,我們還可以對DataSet添加另外的TableAdapter，其包含的方法就是那些需要返回“額外列”的方法.就本問而言，我們可以向DataSet添加另一個名為ProductsWithPriceQuartileTableAdapter的TableAdapter，它將Products_SelectWithPriceQuartile存儲過程作為它的主查詢，對要獲取price quartile信息的ASP.NET頁面來說，只需調(diào)用 ProductsWithPriceQuartileTableAdapter即可；而不需要獲取price quartile信息的頁面只需要調(diào)用ProductsTableAdapter即可.

　　這種另外新添加的TableAdapters可能導致某些功(functionality)、作業(yè)(task)重復.比如，如果那些展示PriceQuartile列的頁面也要啟用insert, update,delete功能的話，那么就要對ProductsWithPriceQuartileTableAdapter的InsertCommand, UpdateCommand,DeleteCommand屬性進行適當?shù)脑O置.而我們已經(jīng)對ProductsTableAdapter的這3個屬性進行過設置了，這時就有2種方法來對數(shù)據(jù)庫里的產(chǎn)品進行添加、更新、刪除操作了——使用ProductsTableAdapter類或 ProductsWithPriceQuartileTableAdapter類.

　　本文供下載的代碼里，在NorthwindWithSprocs數(shù)據(jù)集里包含了ProductsWithPriceQuartileTableAdapter class類，演示了這2種方法.

總結：

　　在大多數(shù)情況下，TableAdapter的所有方法返回的數(shù)據(jù)列都是相同的，但有極少數(shù)方法會返回主查詢沒有包含的“額外列”.比如我們在第35章《使用Repeater和DataList單頁面實現(xiàn)主/從報表》里，我們向CategoriesTableAdapter添加了一個方法，該方法除了返回主查詢里的列外，還返回了一個NumberOfProducts列.而在本文，我們考察類了向 ProductsTableAdapter 添加一個方法以返回一個沒有包含在主查詢里的PriceQuartile列.對這種返回來的“額外列”，我們需要向DataTable添加一個對應的列.

　　如果你打算手工向DataTable添加列，我們建議一使用存儲過程.如果用ad-hoc SQL statements的話，任何時候只要重新運行TableAdapter設置向?qū)?，用戶所做的所有定制都要被覆蓋.而用存儲過程的話就不會出現(xiàn)這種情況.

　　祝編程快樂！

作者簡介

　　本系列教程作者 Scott Mitchell，著有六本ASP/ASP.NET方面的書，是4GuysFromRolla.com的創(chuàng)始人，自1998年以來一直應用 微軟Web技術。大家可以點擊查看全部教程《[翻譯]Scott Mitchell 的ASP.NET 2.0數(shù)據(jù)教程》，希望對大家的學習ASP.NET有所幫助。