本文英文原版及代碼下載：
http://www.asp.net/learn/data-access/tutorial-70-cs.aspx

Scott Mitchell 的ASP.NET 2.0數(shù)據(jù)教程之70:為DataTable添加額外的列

導(dǎo)言：

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

如果TableAdapter的方法返回的列涵蓋在主查詢里，工作起來(lái)沒有問題。但如果返回的列并沒有涵蓋在主查詢，那么我們就需要對(duì)DataTable的構(gòu)架進(jìn)行擴(kuò)充.在第35章《Master/Detail Using a Bulleted List of Master Records with a Details DataList》里，我們向CategoriesTableAdapter添加方法以返回 CategoryID, CategoryName, Description和NumberOfProducts列。其中前3列是涵蓋在主查詢里的，而NumberOfProducts列沒有在主查詢里定義，它返回的是每個(gè)category相關(guān)產(chǎn)品的數(shù)目.我們可以向CategoriesDataTable手工添加一列，以便于統(tǒng)計(jì)從新方法返回的NumberOfProducts列的值.

在第54章《Uploading Files》我們探討過(guò)，對(duì)使用ad-hoc SQL statements構(gòu)建且其方法返回的列超出主查詢范圍的TableAdapters必須多加留意.因?yàn)橐坏┲匦逻\(yùn)行設(shè)置向?qū)У脑挘鼘?duì)TableAdapter的方法進(jìn)行更新，使其返回的列與主查詢相匹配.不過(guò)如果使用存儲(chǔ)過(guò)程的話就不會(huì)出現(xiàn)這種情況.

在本文我們將考察如何擴(kuò)展DataTable的構(gòu)架以包含額外的列。我們都知道使用ad-hoc SQL statements構(gòu)架的TableAdapter不穩(wěn)定，本文我們將用存儲(chǔ)過(guò)程來(lái)構(gòu)架.你可以參考第67章《the Creating New Stored Procedures for the Typed DataSet’s TableAdapters》和第68章《Using Existing Stored Procedures for the Typed DataSet’s TableAdapters》來(lái)獲取設(shè)置TableAdapter使用存儲(chǔ)過(guò)程的更多信息.

第一步：向ProductsDataTable添加一個(gè)PriceQuartile列

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

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

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

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

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

圖1：向ProductsDataTable新添一列

這將向DataTable新添一列，名為“Column1”，類型為System.String.我們需要將該列的名稱改為“PriceQuartile”，類型改為System.Int32，因?yàn)樗闹到橛?到4之間.在ProductsDataTable 選中我們新添加的列，在屬性窗口里設(shè)置其Name屬性為 “PriceQuartile”，DataType屬性為System.Int32.

圖2：設(shè)置該新列的Name 和 DataType屬性

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

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

現(xiàn)在我們已經(jīng)對(duì)ProductsDataTable進(jìn)行了更新以包含PriceQuartile列，我們將要?jiǎng)?chuàng)建一個(gè)GetProductsWithPriceQuartile方法.在TableAdapter上單擊右鍵，再選擇“Add Query”.這將開啟TableAdapter查詢?cè)O(shè)置向?qū)В紫仍儐栁覀兪鞘褂胊d-hoc SQL statements還是使用現(xiàn)有的存儲(chǔ)過(guò)程或新建一個(gè)存儲(chǔ)過(guò)程.我們選擇“Create new stored procedure”，再點(diǎn)Next.

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

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

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

接下來(lái)，我們?cè)谙驅(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ù)，它將結(jié)果劃分為4組，將UnitPrice值按降序分組.

不幸的是，查詢構(gòu)造器(Query Builder)不能解析關(guān)鍵字OVER，并拋出一個(gè)錯(cuò)誤信息。因此，直接在向?qū)У奈谋究蚶镦I入上述代碼，而不要使用查詢構(gòu)造器.
注意：
關(guān)于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 )

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

圖5：將新存儲(chǔ)過(guò)程命名為Products_SelectWithPriceQuartile

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

圖6：對(duì)TableAdapter的方法命名并點(diǎn)Finish

當(dāng)指定了SELECT查詢，并對(duì)存儲(chǔ)過(guò)程和TableAdapter的方法命名后，點(diǎn)Finish完成向?qū)А＿@時(shí)你將看到1到2條警告信息，說(shuō)“The OVER SQL construct or statement is not supported.” 不必理會(huì)它.

完成向?qū)Ш螅揟ableAdapter將會(huì)包含F(xiàn)illWithPriceQuartile 和GetProductsWithPriceQuartile方法，并且數(shù)據(jù)庫(kù)將包含一個(gè)名為Products_SelectWithPriceQuartile的存儲(chǔ)過(guò)程。花點(diǎn)時(shí)間來(lái)驗(yàn)證一下，檢查數(shù)據(jù)庫(kù)，如果你沒有看到我們剛添加的存儲(chǔ)過(guò)程，在存儲(chǔ)過(guò)程文件夾上右鍵單擊，選“刷新”.

圖7：驗(yàn)證新方法是否添加到TableAdapter

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

注意：

使用存儲(chǔ)過(guò)程來(lái)替換ad-hoc SQL statements的好處之一是重新運(yùn)行TableAdapter設(shè)置向?qū)У脑挷⒉粫?huì)改動(dòng)存儲(chǔ)過(guò)程返回的列.我們可以作一個(gè)驗(yàn)證，在TableAdapter上右鍵單擊，選“Configure”項(xiàng)，以啟動(dòng)向?qū)В缓簏c(diǎn)Finish完成向?qū)А＝酉聛?lái)，我們?cè)跀?shù)據(jù)庫(kù)里查看Products_SelectWithPriceQuartile存儲(chǔ)過(guò)程.我們注意到其返回的列并沒有發(fā)生變化.如果我們使用的是ad-hoc SQL statements的話，重新運(yùn)行向?qū)?huì)使查詢返回的列與主查詢的列相匹配，因此它將把GetProductsWithPriceQuartile方法里使用的查詢里的NTILE statement刪除掉.

當(dāng)調(diào)用數(shù)據(jù)訪問層的GetProductsWithPriceQuartile方法時(shí)，TableAdapter將執(zhí)Products_SelectWithPriceQuartile存儲(chǔ)過(guò)程，并為返回的每條記錄向ProductsDataTable添加對(duì)應(yīng)的row.存儲(chǔ)過(guò)程返回的數(shù)據(jù)域(data fields)將映射到ProductsDataTable的列.因?yàn)樵摯鎯?chǔ)過(guò)程要返回一個(gè)PriceQuartile數(shù)據(jù)域，所以它的值將分配給ProductsDataTable的PriceQuartile列.

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

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

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

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

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

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

第四步：在一個(gè)ASP.NET頁(yè)面展示Price Quartile信息

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

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

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

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

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

<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為在瀏覽器里登錄該頁(yè)面的情況，我們注意到，最開始產(chǎn)品按price的降序排列，同時(shí)每個(gè)產(chǎn)品都有相應(yīng)的PriceQuartile值，當(dāng)然這些數(shù)據(jù)也可以按其它標(biāo)準(zhǔn)來(lái)排序，如圖12所示。

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

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

注意：
只需要很少的代碼，我們就可以根據(jù)每行PriceQuartile值的不同而顯示不同的顏色，比如對(duì)值為1的行顯示為淺綠色，對(duì)值為2的行顯示為淺黃色，以此類推.你可以花點(diǎn)時(shí)間來(lái)實(shí)現(xiàn)該功能，如果有必要的話，你可以參閱第11章《Custom Formatting Based Upon Data》

另一種途徑——?jiǎng)?chuàng)建另一個(gè)TableAdapter

正如我們?cè)诒疚目吹降模?dāng)向TableAdapter添加的方法返回的列超出了主查詢范圍的時(shí)候，我們可以向DataTable添加相應(yīng)的列即可.對(duì)TableAdapter而言，如果當(dāng)其包含的返回“額外列”的方法較少且“額外列”不是很多的時(shí)候，這種途徑才能正常工作。

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

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

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

總結(jié)：

在大多數(shù)情況下，TableAdapter的所有方法返回的數(shù)據(jù)列都是相同的，但有極少數(shù)方法會(huì)返回主查詢沒有包含的“額外列”.比如我們?cè)诘?5章《Master/Detail Using a Bulleted List of Master Records with a Details DataList》里，我們向CategoriesTableAdapter添加了一個(gè)方法，該方法除了返回主查詢里的列外，還返回了一個(gè)NumberOfProducts列.而在本文，我們考察類了向 ProductsTableAdapter 添加一個(gè)方法以返回一個(gè)沒有包含在主查詢里的PriceQuartile列.對(duì)這種返回來(lái)的“額外列”，我們需要向DataTable添加一個(gè)對(duì)應(yīng)的列.

如果你打算手工向DataTable添加列，我們建議一使用存儲(chǔ)過(guò)程.如果用ad-hoc SQL statements的話，任何時(shí)候只要重新運(yùn)行TableAdapter設(shè)置向?qū)В脩羲龅乃卸ㄖ贫家桓采w.而用存儲(chǔ)過(guò)程的話就不會(huì)出現(xiàn)這種情況.

祝編程快樂！

作者簡(jiǎn)介
Scott Mitchell，著有六本ASP/ASP.NET方面的書，是4GuysFromRolla.com的創(chuàng)始人，自1998年以來(lái)一直應(yīng)用 微軟Web技術(shù)。Scott是個(gè)獨(dú)立的技術(shù)咨詢顧問，培訓(xùn)師，作家，最近完成了將由Sams出版社出版的新作，24小時(shí)內(nèi)精通ASP.NET 2.0。他的聯(lián)系電郵為 mitchell@4guysfromrolla.com ，也可以通過(guò)他的博客 http://ScottOnWriting.NET 與他聯(lián)系。

Scott Mitchell 的ASP.NET 2.0數(shù)據(jù)教程之70:為DataTable添加額外的列