導(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將有對應(yīng)的3個(gè)列A, B,和C.除了主查詢以外,TableAdapter還可以包含其他的查詢,可能是返回基于某些參數(shù)的數(shù)據(jù)。比如,ProductsTableAdapter的主查詢返回所有產(chǎn)品的信息,此外,ProductsTableAdapter還包含諸如GetProductsByCategoryID(categoryID) 和 GetProductByProductID(productID)的方法,它們根據(jù)指派的參數(shù)返回特定的產(chǎn)品信息.
如果TableAdapter的方法返回的列涵蓋在主查詢里,工作起來沒有問題。但如果返回的列并沒有涵蓋在主查詢,那么我們就需要對DataTable的構(gòu)架進(jìn)行擴(kuò)充.在第35章《使用Repeater和DataList單頁面實(shí)現(xiàn)主/從報(bào)表》里,我們向CategoriesTableAdapter添加方法以返回 CategoryID, CategoryName, Description和NumberOfProducts列。其中前3列是涵蓋在主查詢里的,而NumberOfProducts列沒有在主查詢里定義,它返回的是每個(gè)category相關(guān)產(chǎn)品的數(shù)目.我們可以向CategoriesDataTable手工添加一列,以便于統(tǒng)計(jì)從新方法返回的NumberOfProducts列的值.
在第52章《使用FileUpload上傳文件》我們探討過,對使用ad-hoc SQL statements構(gòu)建且其方法返回的列超出主查詢范圍的TableAdapters必須多加留意.因?yàn)橐坏┲匦逻\(yùn)行設(shè)置向?qū)У脑?,它將對TableAdapter的方法進(jìn)行更新,使其返回的列與主查詢相匹配.不過如果使用存儲過程的話就不會出現(xiàn)這種情況.
在本文我們將考察如何擴(kuò)展DataTable的構(gòu)架以包含額外的列。我們都知道使用ad-hoc SQL statements構(gòu)架的TableAdapter不穩(wěn)定,本文我們將用存儲過程來構(gòu)架.你可以參考第65章《在TableAdapters中創(chuàng)建新的存儲過程》和第66章《在TableAdapters中使用現(xiàn)有的存儲過程》來獲取設(shè)置TableAdapter使用存儲過程的更多信息.
第一步:向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ù)來衡量產(chǎn)品價(jià)格下跌程度.如果產(chǎn)品價(jià)格上升了25%,那么其值為1,如果下降為25%,那么其值為4.在我們創(chuàng)建一個(gè)存儲過程來返回這種信息之前,我們首先需要更新ProductsDataTable,新添一列來包含GetProductsWithPriceQuartile方法返回的 PriceQuartile值.
打開NorthwindWithSprocs數(shù)據(jù)集,在ProductsDataTable上右鍵單擊,選擇“ Add” ,再選擇“Column”.
![](/d/20211017/6a1921fe9145597933fc5c52879388bf.gif)
圖1:向ProductsDataTable新添一列
這將向DataTable新添一列,名為“Column1”,類型為System.String.我們需要將該列的名稱改為“PriceQuartile”,類型改為System.Int32,因?yàn)樗闹到橛?到4之間.在ProductsDataTable 選中我們新添加的列,在屬性窗口里設(shè)置其Name屬性為 “PriceQuartile”,DataType屬性為System.Int32.
![](/d/20211017/859445c64bd7e56a7aa8ebedeb4ad51b.gif)
圖2:設(shè)置該新列的Name 和 DataType屬性
就像圖2所示,我們還可以設(shè)置其它的屬性.比如,是否該列的值必須為unique;如果該列為自增列,其值是否允許為NULL等等.不過我們這里使用其默認(rèn)值.
第二步:創(chuàng)建GetProductsWithPriceQuartile方法
現(xiàn)在我們已經(jīng)對ProductsDataTable進(jìn)行了更新以包含PriceQuartile列,我們將要?jiǎng)?chuàng)建一個(gè)GetProductsWithPriceQuartile方法.在TableAdapter上單擊右鍵,再選擇“Add Query”.這將開啟TableAdapter查詢設(shè)置向?qū)?,它首先詢問我們是使用ad-hoc SQL statements還是使用現(xiàn)有的存儲過程或新建一個(gè)存儲過程.我們選擇“Create new stored procedure”,再點(diǎn)Next.
![](/d/20211017/c12e3895c26547bff820aec5f761115e.gif)
圖3:在TableAdapter向?qū)Ю飫?chuàng)建新的存儲過程
接下來,如圖4所示,向?qū)г儐栁覀兲砑拥氖悄欠N類型的查詢,由于GetProductsWithPriceQuartile方法將返回Products表的所有記錄以及所有列,我們選擇“SELECT which returns rows”項(xiàng),再點(diǎn)Next.
![](/d/20211017/93a731d9e8dd4a5f0036e1c5a35fc1bd.gif)
圖4:查詢將是一個(gè)返回多個(gè)行的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ù),它將結(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)樾麓鎯^程重命名,我們?nèi)∶麨镻roducts_SelectWithPriceQuartile再點(diǎn)Next.
![](/d/20211017/80303f3ad3a01d6b362c0e662f375efe.gif)
圖5:將新存儲過程命名為Products_SelectWithPriceQuartile
最后我們要為TableAdapter的方法命名,選中“Fill a DataTable” 和 “Return a DataTable”兩項(xiàng),并重命名為 FillWithPriceQuartile 和GetProductsWithPriceQuartile.
![](/d/20211017/045b10f7542717dfec81b54ef19e1524.gif)
圖6:對TableAdapter的方法命名并點(diǎn)Finish
當(dāng)指定了SELECT查詢,并對存儲過程和TableAdapter的方法命名后,點(diǎn)Finish完成向?qū)?。這時(shí)你將看到1到2條警告信息,說“The OVER SQL construct or statement is not supported.” 不必理會它.
完成向?qū)Ш?,該TableAdapter將會包含F(xiàn)illWithPriceQuartile 和GetProductsWithPriceQuartile方法,并且數(shù)據(jù)庫將包含一個(gè)名為Products_SelectWithPriceQuartile的存儲過程?;c(diǎn)時(shí)間來驗(yàn)證一下,檢查數(shù)據(jù)庫,如果你沒有看到我們剛添加的存儲過程,在存儲過程文件夾上右鍵單擊,選“刷新”.
![](/d/20211017/f1158dfa44d55615fb958a710ebab170.gif)
圖7:驗(yàn)證新方法是否添加到TableAdapter
![](/d/20211017/56e9593dcad175bee34458798b6113d0.gif)
圖8:確保數(shù)據(jù)庫包含Products_SelectWithPriceQuartile存儲過程
注意:使用存儲過程來替換ad-hoc SQL statements的好處之一是重新運(yùn)行TableAdapter設(shè)置向?qū)У脑挷⒉粫膭?dòng)存儲過程返回的列.我們可以作一個(gè)驗(yàn)證,在TableAdapter上右鍵單擊,選“Configure”項(xiàng),以啟動(dòng)向?qū)?,然后點(diǎn)Finish完成向?qū)?。接下來,我們在?shù)據(jù)庫里查看Products_SelectWithPriceQuartile存儲過程.我們注意到其返回的列并沒有發(fā)生變化.如果我們使用的是ad-hoc SQL statements的話,重新運(yùn)行向?qū)共樵兎祷氐牧信c主查詢的列相匹配,因此它將把GetProductsWithPriceQuartile方法里使用的查詢里的NTILE statement刪除掉.
當(dāng)調(diào)用數(shù)據(jù)訪問層的GetProductsWithPriceQuartile方法時(shí),TableAdapter將執(zhí)Products_SelectWithPriceQuartile存儲過程,并為返回的每條記錄向ProductsDataTable添加對應(yīng)的row.存儲過程返回的數(shù)據(jù)域(data fields)將映射到ProductsDataTable的列.因?yàn)樵摯鎯^程要返回一個(gè)PriceQuartile數(shù)據(jù)域,所以它的值將分配給ProductsDataTable的PriceQuartile列.
對于那些不返回PriceQuartile數(shù)據(jù)域的方法而言,PriceQuartile列的值由其DefaultValue屬性指定. 如圖2所示,該默認(rèn)值為DBNull。如果你想指定為其他值,僅僅改動(dòng)DefaultValue屬性即可,但一定要是一個(gè)有效的值(比如,PriceQuartile列的值一定要是一個(gè)System.Int32類型的值).
現(xiàn)在我們完成了向DataTable添加額外列的必要的步驟,接下來我們要?jiǎng)?chuàng)建一個(gè)ASP.NET 頁面來展示每個(gè)產(chǎn)品的 name, price,以及price quartile.不過我們要先對業(yè)務(wù)邏輯層進(jìn)行更新,以包含一個(gè)方法來調(diào)用數(shù)據(jù)訪問層的GetProductsWithPriceQuartile方法.我們將在第3步更新業(yè)務(wù)邏輯層,在第4步創(chuàng)建一個(gè)ASP.NET頁面.
第三步:更新業(yè)務(wù)邏輯層
我們在表現(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ù)訪問層對應(yīng)的GetProductsWithPriceQuartile方法并返回其結(jié)果.
第四步:在一個(gè)ASP.NET頁面展示Price Quartile信息
完成對業(yè)務(wù)邏輯層的修改后,我們將創(chuàng)建一個(gè)ASP.NET頁面來顯示每個(gè)產(chǎn)品的price quartile信息.打開AdvancedDAL文件夾里的AddingColumns.aspx頁面,從工具箱拖一個(gè) GridView控件到頁面,設(shè)置其ID為Products.在其智能標(biāo)簽里將其綁定到一個(gè)名為ProductsDataSource的新的ObjectDataSource控件,設(shè)置該控件調(diào)用ProductsBLLWithSprocs class類的GetProductsWithPriceQuartile方法,在UPDATE, INSERT,和DELETE標(biāo)簽里選“(None)”.
![](/d/20211017/3c5296a58ddbac1600480901c3b6befc.gif)
圖9:設(shè)置ObjectDataSource調(diào)用ProductsBLLWithSprocs類
![](/d/20211017/9a9f84d812c60e185833401e045c7b4a.gif)
圖10:調(diào)用GetProductsWithPriceQuartile方法獲取產(chǎn)品信息
完成設(shè)置向?qū)Ш螅?Visual Studio會為GridView添加BoundField或CheckBoxField列,其中包括PriceQuartile列. 將ProductName, UnitPrice,PriceQuartile以外的列全部刪除,設(shè)置UnitPrice列為貨幣格式.并將UnitPrice 和 PriceQuartile列放在右邊,居中。 最后分別將這3列的HeaderText屬性設(shè)置為“Product”, “Price”,“Price Quartile”。同時(shí)啟用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的降序排列,同時(shí)每個(gè)產(chǎn)品都有相應(yīng)的PriceQuartile值,當(dāng)然這些數(shù)據(jù)也可以按其它標(biāo)準(zhǔn)來排序,如圖12所示。
![](/d/20211017/58675b3b8af20c54535342551acce5c0.gif)
圖11:產(chǎn)品按Prices來排序
![](/d/20211017/c96c5c5120cebd4b07d99ecc8e12cea8.gif)
圖12:產(chǎn)品按名稱來排序.
注意:只需要很少的代碼,我們就可以根據(jù)每行PriceQuartile值的不同而顯示不同的顏色,比如對值為1的行顯示為淺綠色,對值為2的行顯示為淺黃色,以此類推.你可以花點(diǎn)時(shí)間來實(shí)現(xiàn)該功能,如果有必要的話,你可以參閱第11章《基于數(shù)據(jù)的自定義格式化》
另一種途徑——?jiǎng)?chuàng)建另一個(gè)TableAdapter
正如我們在本文看到的,當(dāng)向TableAdapter添加的方法返回的列超出了主查詢范圍的時(shí)候,我們可以向DataTable添加相應(yīng)的列即可.對TableAdapter而言,如果當(dāng)其包含的返回“額外列”的方法較少且“額外列”不是很多的時(shí)候,這種途徑才能正常工作。
除了往DataTable添加列以外,我們還可以對DataSet添加另外的TableAdapter,其包含的方法就是那些需要返回“額外列”的方法.就本問而言,我們可以向DataSet添加另一個(gè)名為ProductsWithPriceQuartileTableAdapter的TableAdapter,它將Products_SelectWithPriceQuartile存儲過程作為它的主查詢,對要獲取price quartile信息的ASP.NET頁面來說,只需調(diào)用 ProductsWithPriceQuartileTableAdapter即可;而不需要獲取price quartile信息的頁面只需要調(diào)用ProductsTableAdapter即可.
這種另外新添加的TableAdapters可能導(dǎo)致某些功(functionality)、作業(yè)(task)重復(fù).比如,如果那些展示PriceQuartile列的頁面也要啟用insert, update,delete功能的話,那么就要對ProductsWithPriceQuartileTableAdapter的InsertCommand, UpdateCommand,DeleteCommand屬性進(jìn)行適當(dāng)?shù)脑O(shè)置.而我們已經(jīng)對ProductsTableAdapter的這3個(gè)屬性進(jìn)行過設(shè)置了,這時(shí)就有2種方法來對數(shù)據(jù)庫里的產(chǎn)品進(jìn)行添加、更新、刪除操作了——使用ProductsTableAdapter類或 ProductsWithPriceQuartileTableAdapter類.
本文供下載的代碼里,在NorthwindWithSprocs數(shù)據(jù)集里包含了ProductsWithPriceQuartileTableAdapter class類,演示了這2種方法.
總結(jié):
在大多數(shù)情況下,TableAdapter的所有方法返回的數(shù)據(jù)列都是相同的,但有極少數(shù)方法會返回主查詢沒有包含的“額外列”.比如我們在第35章《使用Repeater和DataList單頁面實(shí)現(xiàn)主/從報(bào)表》里,我們向CategoriesTableAdapter添加了一個(gè)方法,該方法除了返回主查詢里的列外,還返回了一個(gè)NumberOfProducts列.而在本文,我們考察類了向 ProductsTableAdapter 添加一個(gè)方法以返回一個(gè)沒有包含在主查詢里的PriceQuartile列.對這種返回來的“額外列”,我們需要向DataTable添加一個(gè)對應(yīng)的列.
如果你打算手工向DataTable添加列,我們建議一使用存儲過程.如果用ad-hoc SQL statements的話,任何時(shí)候只要重新運(yùn)行TableAdapter設(shè)置向?qū)?,用戶所做的所有定制都要被覆蓋.而用存儲過程的話就不會出現(xiàn)這種情況.
祝編程快樂!
作者簡介
本系列教程作者 Scott Mitchell,著有六本ASP/ASP.NET方面的書,是4GuysFromRolla.com的創(chuàng)始人,自1998年以來一直應(yīng)用 微軟Web技術(shù)。大家可以點(diǎn)擊查看全部教程《[翻譯]Scott Mitchell 的ASP.NET 2.0數(shù)據(jù)教程》,希望對大家的學(xué)習(xí)ASP.NET有所幫助。
您可能感興趣的文章:- ASP.NET中DataTable與DataSet之間的轉(zhuǎn)換示例
- Asp.net中DataTable導(dǎo)出到Excel的方法介紹
- asp.net 讀取Excel數(shù)據(jù)到DataTable的代碼
- ASP.NET DataTable去掉重復(fù)行的2種方法
- Asp.net實(shí)現(xiàn)選擇性的保留DataTable中的列
- ASP.NET中實(shí)現(xiàn)根據(jù)匿名類、datatable、sql生成實(shí)體類
- asp.net實(shí)現(xiàn)數(shù)據(jù)從DataTable導(dǎo)入到Excel文件并創(chuàng)建表的方法
- asp.net使用DataTable構(gòu)造Json字符串的方法
- asp.net異步獲取datatable并顯示的實(shí)現(xiàn)方法
- asp.net DataTable相關(guān)操作集錦(篩選,取前N條數(shù)據(jù),去重復(fù)行,獲取指定列數(shù)據(jù)等)