導言
在前面一章裡我們學習了如何在一個頁裡顯示主/從信息.另外一種經常使用的模式就是將主從信息用兩個頁分別顯示.在前面的跨頁面的主/從報表 我們通過GridView顯示所有的supplier來使用這個模式.GridView裡包含一個HyperLinkField,鏈接到另外一個頁,並將SupplierID通過querystring傳過去.第二個頁使用GridView列出了選中的supplier提供的product.
這樣的兩頁主/從表也可以用DataList和Repeater來實現.唯一的區別是DataList和Repeater都不提供HyperLinkField.所以我們需要添加一個HyperLink控件或者在ItemTemplate裡使用HTML <a>.HyperLink的NavigateUrl屬性和<a>的href屬性可以通過聲明或者編程來自定義.
本章我們將探討使用Repeater列出categories.每個list item都包含了category的name和description.通過name可以直接鏈接到第二個頁面.在第二頁裡用DataList顯示選中的categroy提供的proudct.
第一步: 列出Categories
所有創建主從表的第一步都是顯示主記錄.因此,我們首先在"主"頁裡顯示categories.打開DataListRepeaterFiltering文件夾裡的CategoryListMaster.aspx頁,添加一個Repeater,然後通過智能標簽添加一個ObjectDataSource.使用CategriesBLL類的GetCategories方法配置它.見圖1.
圖 1:使用CategoriesBLL類的GetCategories方法配置ObjectDataSource
我們先不關心如何添加link.將Repeater的template配置成顯示每個category的name和description.見下面的代碼:
<asp:Repeater ID="Repeater1" runat="server" DataSourceID="ObjectDataSource1" EnableViewState="False"> <HeaderTemplate> <ul> </HeaderTemplate> <ItemTemplate> <li><%# Eval("CategoryName") %> - <%# Eval("Description") %></li> </ItemTemplate> <FooterTemplate> </ul> </FooterTemplate> </asp:Repeater> <asp:ObjectDataSource ID="ObjectDataSource1" runat="server" OldValuesParameterFormatString="original_{0}" SelectMethod="GetCategories" TypeName="CategoriesBLL"> </asp:ObjectDataSource>
完成了上面的代碼後,在浏覽器裡浏覽頁面.如圖2所示.
圖 2: 列出所有的 Category
第二步: 將Category Name 轉換成鏈到Details Page 的Link
我們現在來添加一個link,當用戶點擊時,將會鏈到第二個頁(ProductsForCategoryDetails.aspx),在這個頁裡顯示"從"信息.這頁裡用DataList顯示選中的category的product.為了判斷是哪個category的鏈接被點了,我們需要將CategoryID傳到第二頁.最直接的方法是通過querystring.我們通過名為CategoryID的querystring字段將這個傳給ProductsForCategoryDetails.aspx.例如,查看Beverages categroy下的product,CategoryID為1.用戶將訪問ProductsForCategoryDetails.aspx?CategoryID=1頁.
為了創建hyperlink我們需要添加HyperLink控件或者在ItemTemplate裡添加HTML<a>.在每行的hyperlink都相同的情況下,兩種方法都足夠了.對Repeater來說我更願意使用<a>.見下面的代碼:
<li> <a href='ProductsForCategoryDetails.aspx?CategoryID=<%# Eval("CategoryID") %>'> <%# Eval("CategoryName") %> </a> - <%# Eval("Description") %> </li>
注意CategoryID可以直接通過href屬性寫入.注意引號和省略號.
<li> <asp:HyperLink runat="server" Text='<%# Eval("CategoryName") %>' NavigateUrl='<%# "ProductsForCategoryDetails.aspx?CategoryID=" & Eval("CategoryID") %>'> </asp:HyperLink> - <%# Eval("Description") %> </li>
注意在綁定語法裡靜態URL— ProductsForCategoryDetails.aspx?CategoryID— 是如何直接和Eval("CategoryID")的結果串聯.
使用HyperLink控件的一個好處是如果需要的話可以編程訪問Repeater的ItemDataBound event handler.例如你可以將沒有關聯product的categories顯示為文本,而不是link.將那些沒有關聯product的categories的HyperLink的NavigateUrl屬性設為一個空的字符串,這樣category name就顯示為一個text(而不是link).更多的通過ItemDataBound event handler的編程來格式化DataList和Repeater內容的信息請看格式化DataList和Repeater的數據.如果你在跟著教程做的話,使用上面兩種方法都可以.當浏覽這頁時,每個category name都以link的形式呈現,可以鏈接到ProductsForCategoryDetails.aspx頁,並將CategoryID的值傳過去.見圖3.
圖 3: Category Names 現在鏈接到ProductsForCategoryDetails.aspx頁
第三步: 列出選中的Category下的Products
完成CategoryListMaster.aspx頁後,我們現在來完成"從"頁,ProductsForCategoryDetails.aspx.打開這個頁,拖一個DataList控件進來,並將ID設置為ProductsInCategory.然後在智能標簽裡選擇添加一個名為ProductsInCategoryDataSource的ObjectDataSource.並用ProductsBLL類的GetProductsByCategoryID(categoryID)方法配置它.在INSERT,UPDATE,DELETE標簽裡選擇None.
圖 4: 使用ProductsBLL類的GetProductsByCategoryID(categoryID)方法配置ObjectDataSource
由於GetProductsByCategoryID(categoryID)方法接收一個參數,所以向導會提示我們指定參數來源.設置parameter source為QueryString,QueryStringField為CategoryID.
圖 5: 使用Querystring Field 作為Parameter Source
象前面教程裡看到的那樣,完成數據源配置後,Visual Studio會自動創建一個ItemTemplate列出每個字段的name和value.我們只顯示name,supplier和price.將DataList的RepeatColumns屬性設為2.完成這些後你的聲明標記看起來應該和下面差不多:
<asp:DataList ID="ProductsInCategory" runat="server" DataKeyField="ProductID" RepeatColumns="2" DataSourceID="ProductsInCategoryDataSource" EnableViewState="False"> <ItemTemplate> <h5><%# Eval("ProductName") %></h5> <p> Supplied by <%# Eval("SupplierName") %><br /> <%# Eval("UnitPrice", "{0:C}") %> </p> </ItemTemplate> </asp:DataList> <asp:ObjectDataSource ID="ProductsInCategoryDataSource" OldValuesParameterFormatString="original_{0}" runat="server" SelectMethod="GetProductsByCategoryID" TypeName="ProductsBLL"> <SelectParameters> <asp:QueryStringParameter Name="categoryID" QueryStringField="CategoryID" Type="Int32" /> </SelectParameters> </asp:ObjectDataSource>
現在我們來看看效果,先浏覽CategoryListMater.aspx頁.然後在列出的category上點一個link.這樣就會跳到ProductsForCategoryDetails.aspx頁,並將CategoryID通過querystring傳過去.ProductsInCategoryDataSource ObjectDataSource會返回指定category的product並將它們顯示在DataList中,每行兩個.圖6是點擊Beverages的截圖.
圖 6: 每行兩個的顯示Beverages
第四步: 在ProductsForCategoryDetails.aspx裡顯示 Category 信息
當用戶在CategoryListMaster.aspx頁點擊一個category時,會跳到ProductsForCategoryDetails.aspx頁並顯示選中的categry下的product.然而在這個頁裡並沒有包含哪個category被選中了的信息.用戶可能想點Beverages,但是結果點了Condiments,這時他沒辦法知道自己是否點錯了.為了剞劂這個問題,我們可以將選中的category信息顯示在ProductsForCategoryDetails.aspx頁的頂部(name和description).在ProductsForCategoryDetails.aspx的Repeater上添加一個FormView.然後通過智能標簽添加一個名為CategoryDataSource的ObjectDataSource,並用CategoriesBLL類的GetCategoryByCategoryID(categoryID)方法配置它.
圖 7: 配置CategoryDataSource
在第三步增加ProductsInCategoryDataSource ObjectDataSource時,向導提示我們為GetCategoryByCategoryID(categoryID)方法指定輸入參數.在這裡我們使用和前面一樣的配置,將parameter source設為QueryString,QueryStringField設為CategoryID(見圖5).
完成向導後,Visual Studio會為FormView自動創建ItemTemplate,EditItemTemplate和InsertItemTemplate.由於只提供只讀的界面,我們將EditItemTemplate和InsertItemTemplate.當然你也可以自定義FormView的ItemTemplate.完成上面的操作偶你的標記語言應該和下面差不多:
<asp:FormView ID="FormView1" runat="server" DataKeyNames="CategoryID" DataSourceID="CategoryDataSource" EnableViewState="False" Width="100%"> <ItemTemplate> <h3> <asp:Label ID="CategoryNameLabel" runat="server" Text='<%# Bind("CategoryName") %>' /> </h3> <p> <asp:Label ID="DescriptionLabel" runat="server" Text='<%# Bind("Description") %>' /> </p> </ItemTemplate> </asp:FormView> <asp:ObjectDataSource ID="CategoryDataSource" runat="server" OldValuesParameterFormatString="original_{0}" SelectMethod="GetCategoryByCategoryID" TypeName="CategoriesBLL"> <SelectParameters> <asp:QueryStringParameter Name="categoryID" Type="Int32" QueryStringField="CategoryID" /> </SelectParameters> </asp:ObjectDataSource>
注意:我們還在FormView上加了一個HyperLink,它會將用戶鏈回到category頁(CategoryListMaster.aspx).
圖 8: Category 信息顯示在頁的頂部
第五步: 如果選中的Category下無 Products 則顯示一個提示信息
無論有沒有相關聯的product,CategoryListMaster.aspx頁都會列出所有的category.如果用戶點了一個無product的category,由於數據源為空,在ProductsForCategoryDetails.aspx頁裡的DataList將不會顯示.在前面的教程裡我們看到了GridView提供了一個EmptyDataText屬性,可以用來在數據源無記錄時定義一個消息.不幸的是DataList和Repeater都沒有這個屬性.
為了在category無product時提示用戶,我們需要在頁裡加一個Label控件.在沒有匹配的product時將它的Text屬性設置為要顯示的信息.我們需要根據DataList有沒有內容來編程設置它的Visible屬性.首先在DataList下加一個Label控件.將它的ID設為NoProductsMessage,Text設為"There are no products for the selected category…".然後我們根據是否有數據綁定到ProductsInCategory DataList來設置它的Visible屬性.這一步需要在數據綁定到DataList之後做.對GridView,DetailsView和FormView來說,我們可以為DataBound事件創建一個event handler.在數據綁定完後激發.然而DataList和Repeater都沒有DataBound事件.
在這個例子裡我們可以在Page_Load事件處理裡設置Label的Visible屬性..由於數據綁定到DataList先於Page的Load事件.然而,這種方法在一般情況下不會起作用,因為從ObjectDataSource來的數據是在頁面周期之後綁定到DataList.如果顯示的數據基於另一個控件的值,例如,象在使用DropDownList顯示主記錄的主/從表的例子裡,數據直到Page的生命周期的PreRender後才綁定到控件.
一個在所有情況下都起作用的解決方案是在DataList的ItemDataBound(或ItemCreated)事件處理中設置Visible為False.在這種情況下我們知道數據源裡至少有一個數據項,因此可以隱藏NoProductsMessage Label.除了這個event handler外,我們還需要一個DataList DataBingd的事件處理,來初始化Label的Visible屬性為True.由於DataBinding時間在ItemDataBound事件後激發,Label的Visible屬性會初始化為True.如果有數據,它會被設為False.見下面的代碼:
protected void ProductsInCategory_DataBinding(object sender, EventArgs e) { // Show the Label NoProductsMessage.Visible = true; } protected void ProductsInCategory_ItemDataBound(object sender, DataListItemEventArgs e) { // If we have a data item, hide the Label if (e.Item.ItemType == ListItemType.Item || e.Item.ItemType == ListItemType.AlternatingItem) NoProductsMessage.Visible = false; }
在Northwind數據庫裡的category都和一個或多個product關聯.為了測試上面的功能,我手動修改了Northwind數據庫,將Produce category(CategoryID=7)的product都和Seafood category(CategoryID=8)關聯起來.這個可以在Server Explorer裡選擇New Query並使用下面的語句:
UPDATE Products SET CategoryID = 8 WHERE CategoryID = 7
更新了數據庫後,回到CategoryListMaster.aspx頁,點Produce鏈接.由於Produce category下面已經沒有任何product,所以你會看到"There are no products for the selected category…"的提示,見圖9.
圖 9: 選中的Category下無Product時會顯示一個提示消息
總結
主/從記錄可以在一個頁上顯示,也可以在兩個頁上分別顯示.在本章裡我們學習了如何在"主"頁上用Repeater列出category,將相關的product在"從"頁上列出.每個"主"頁上的項都包含一個鏈到"從"頁的link,並將行的CategoryID值傳過去.
在"從"頁裡通過ProductsBLL類的GetProductsByCategoryID(categoryID)方法返回product.categoryID參數通過querystring的CategoryID值指定.而且我們還將category的細節使用FormView顯示在"從"頁裡,當選中的category無關聯product時,會顯示一條提示信息.
祝編程愉快!
作者簡介
Scott Mitchell,著有六本ASP/ASP.NET方面的書,是4GuysFromRolla.com的創始人,自1998年以來一直應用 微軟Web技術。Scott是個獨立的技術咨詢顧問,培訓師,作家,最近完成了將由Sams出版社出版的新作,24小時內精通ASP.NET 2.0。他的聯系電郵為[email protected],也可以通過他的博客http://ScottOnWriting.NET與他聯系。