在ASP.NET 2.0中操作數(shù)據(jù)之四十五:DataList和Repeater里的自定義Button
導(dǎo)言
在前面關(guān)于DataList 和Repeater 的7章教程里,我們分別創(chuàng)建了只讀和可以編輯刪除的例子。為了讓DataList有編輯和刪除的功能,我們?cè)贗temTemplate里添加了一些button,當(dāng)點(diǎn)擊時(shí),引起postback,并根據(jù)button的CommandName屬性激發(fā)相關(guān)的事件。例如,添加一個(gè)CommandName為“Edit”的button,在postback時(shí)會(huì)激發(fā)EditCommand事件,如果CommandName為“Delete”則激發(fā)DeleteCommand。
除了編輯和刪除button,DataList和Repeater還可以包含一些當(dāng)點(diǎn)擊時(shí),執(zhí)行自定義服務(wù)器端邏輯的Button,LinkButton和ImageButton。本章我們將創(chuàng)建一個(gè)在Repeater里列出categories的界面。每個(gè)category都包含一個(gè)button,當(dāng)點(diǎn)擊時(shí)會(huì)列出相關(guān)product。見圖1。
圖 1: 點(diǎn) “Show Products” 顯示目錄下所有product
第一步: 添加教程頁(yè)
首先添加本章需要的頁(yè)。添加一個(gè)名為CustomButtonsDataListRepeater的文件夾。然后添加下面兩個(gè)頁(yè),記得包含Site.master母板頁(yè)。
Default.aspx
CustomButtons.aspx
圖 2: 添加頁(yè)
和其它文件夾一樣,CustomButtonsDataListRepeater文件夾下的Default.aspx頁(yè)會(huì)列出本部分的教程。和前面一樣添加SectionLevelTutorialListing.ascx用戶控件。
圖 3: 添加 SectionLevelTutorialListing.ascx用戶控件
最后,在Web.sitemap里添加這些頁(yè)的信息。見下面的標(biāo)記:
<siteMapNode url="~/CustomButtonsDataListRepeater/Default.aspx" title="Adding Custom Buttons to the DataList and Repeater" description="Samples of DataList and Repeater Reports that Include Buttons for Performing Server-Side Actions"> <siteMapNode url="~/CustomButtonsDataListRepeater/CustomButtons.aspx" title="Using Custom Buttons in the DataList and Repeater's Templates" description="Examines how to add custom Buttons, LinkButtons, or ImageButtons within templates." /> </siteMapNode>
完成后瀏覽該頁(yè)。見圖4。
圖 4: 現(xiàn)在的站點(diǎn)地圖包含了本章的頁(yè)
第二步: 添加 Categories列表
我們需要添加一個(gè)列出所有categories,每個(gè)category都有一個(gè)“Show Products” LinkButton的Repeater。點(diǎn)LinkButton時(shí)會(huì)顯示所有category相關(guān)的products。我們首先創(chuàng)建一個(gè)列出所有categories的Repeater。打開CustomButtons.aspx頁(yè),拖一個(gè)Repeater進(jìn)來,將ID設(shè)為Categories。然后從智能標(biāo)簽里創(chuàng)建一個(gè)名為CategoriesDataSource的ObjectDataSource,用CategoriesBLL類的GetCategories()方法配置它。
圖5: 配置ObjectDataSource
Visual Studio會(huì)根據(jù)數(shù)據(jù)源為DataList創(chuàng)建一個(gè)默認(rèn)的ItemTemplate,而Repeater的templates需要手工定義。而且Repeater的templates需要直接通過聲明代碼來創(chuàng)建和修改(也就是說在智能標(biāo)簽上沒有“Edit Templates”選項(xiàng))
點(diǎn)左下角的源視圖,添加一個(gè)以<h3>顯示category name,以段落description的ItemTemplate。并包含一個(gè)在每個(gè)category之間顯示水平線(<hr />)的SeparatorTemplate。同樣還要添加一個(gè)LinkButton,將Text設(shè)為“Show Products”。完成這些后你的頁(yè)面聲明代碼應(yīng)該和下面差不多:
<asp:Repeater ID="Categories" DataSourceID="CategoriesDataSource" runat="server"> <ItemTemplate> <h3><%# Eval("CategoryName") %></h3> <p> <%# Eval("Description") %> [<asp:LinkButton runat="server" ID="ShowProducts"> Show Products</asp:LinkButton>] </p> </ItemTemplate> <SeparatorTemplate><hr /></SeparatorTemplate> </asp:Repeater> <asp:ObjectDataSource ID="CategoriesDataSource" runat="server" OldValuesParameterFormatString="original_{0}" SelectMethod="GetCategories" TypeName="CategoriesBLL"> </asp:ObjectDataSource>
圖6是瀏覽該頁(yè)的樣子。每個(gè)category name和description都被列出來。當(dāng)點(diǎn)“Show Products” button時(shí)會(huì)引起postback,但是還不執(zhí)行任何功能。
圖 6: 每個(gè) Category'的Name 和 Description 和 “Show Products” LinkButton一起列出
第三步:當(dāng)點(diǎn)“Show Products” LinkButton 時(shí)執(zhí)行服務(wù)器端代碼
任何時(shí)候,當(dāng)DataList或Repeater的template里的Button, LinkButton, ImageButton被點(diǎn)時(shí),會(huì)產(chǎn)生postback,并激發(fā)DataList或Repeater的ItemCommand事件。除了ItemCommand外,如果button'的CommandName 設(shè)為(“Delete”, “Edit”, “Cancel”, “Update”, “Select”)其中一個(gè)時(shí),DataList會(huì)激發(fā)另外一個(gè)事件。但是ItemCommand是都會(huì)激發(fā)的。
當(dāng)DataList或Repeater的template里的Button被點(diǎn)時(shí),通常我們需要獲取哪個(gè)button被點(diǎn)了(一個(gè)控件里可能有多個(gè)button,比如編輯和刪除),還可能需要一些其它的信息(比如那些button被點(diǎn)的item(項(xiàng))的主鍵)。Button, LinkButton, ImageButton提供了兩個(gè)屬性,它們的值可以傳給ItemCommand event handler:
CommandName –表示template里每個(gè)button身份的字符串 。
CommandArgument – 通常用來保存一些值,比如主鍵。
在這個(gè)例子里,將LinkButton的CommandName設(shè)為“ShowProducts”,并將當(dāng)前記錄的主鍵– CategoryID –通過綁定語法綁定到CommandArgument(CategoryArgument='<%# Eval("CategoryID") %>')。完成這些后,LinkButton的聲明語法看起來應(yīng)該和下面差不多:
<asp:LinkButton runat="server" CommandName="ShowProducts" CommandArgument='<%# Eval("CategoryID") %>' ID="ShowProducts"> Show Products</asp:LinkButton>
當(dāng)button被點(diǎn)時(shí),產(chǎn)生postback并激發(fā)DataList或Repeater的ItemCommand事件。Button的CommandName和CommandArgument值被傳到event handler里。
為ItemCommand事件創(chuàng)建一個(gè)event handler,注意event handler的第二個(gè)參數(shù)(名字為e)。這個(gè)參數(shù)的類型為RepeaterCommandEventArgs,它有以下4個(gè)屬性:
CommandArgument – 被點(diǎn)的 button'的CommandArgument property 的值
CommandName – button'的CommandName property 的值
CommandSource – 被點(diǎn) button 的引用
Item – 包含被點(diǎn)button 的 RepeaterItem的引用; 每條綁定到Repeater的記錄被表明為一個(gè) RepeaterItem
由于選擇的category的CategoryID通過CommandArgument傳入,我們可以在ItemCommand event handler里獲取與之相關(guān)的products。這些products在ItemTemplate(我們已經(jīng)添加過了)里綁定到一個(gè)BulletedList。剩下的事就是添加BulletedList,在ItemCommand event handler里引用它,然后將選擇的category的products綁定到BulletedList,我們將在第四步完成這個(gè)。
注意:DataList的ItemCommand event handler傳入了一個(gè)DataListCommandEventArgs類型的對(duì)象,它提供和RepeaterCommandEventArgs 一樣的4個(gè)屬性。
第四步: 顯示選擇的Category的 Products
在ItemTemplate里顯示products可以使用很多控件,我們可以添加一個(gè)嵌套的Repeater,DataList,DropDownList,GridView等。在這里我們使用BulletedList?;氐紺ustomButtons.aspx page頁(yè)的聲明代碼,在“Show Products” LinkButton后添加一個(gè)BulletedList。將ID設(shè)為ProductsInCategory。BulletedList顯示那些通過DataTextField屬性指定的字段值。由于將有product信息綁定到這個(gè)屬性,我們將DataTextField設(shè)為ProductName。
<asp:BulletedList ID="ProductsInCategory" DataTextField="ProductName" runat="server"></asp:BulletedList>
在ItemCommand event handler里通過e.Item.FindControl("ProductsInCategory")引用這個(gè)控件,并與products綁定。
protected void Categories_ItemCommand(object source, RepeaterCommandEventArgs e) { if (e.CommandName == "ShowProducts") { // Determine the CategoryID int categoryID = Convert.ToInt32(e.CommandArgument); // Get the associated products from the ProudctsBLL and bind // them to the BulletedList BulletedList products = (BulletedList)e.Item.FindControl("ProductsInCategory"); ProductsBLL productsAPI = new ProductsBLL(); products.DataSource = productsAPI.GetProductsByCategoryID(categoryID); products.DataBind()); } }
在ItemCommand event handler里執(zhí)行任何操作前,需要先檢查傳入的CommandName。由于ItemCommand event handler在任何button被點(diǎn)時(shí)都會(huì)執(zhí)行,如果在template里有多個(gè)button時(shí)需要通過CommandName的值來辨別需要采取什么操作。由于我們這里只有一個(gè)button,因此在這里檢查CommandName是沒意義的,但是這是一個(gè)好習(xí)慣。然后,選擇的category的CategoryID通過CommandArgument獲取。然后引用Template里的BulletedList并綁定ProductsBLL類的GetProductsByCategoryID(categoryID)方法的結(jié)果。
在前面DataList里使用button的教程里,比如在DataList里編輯和刪除數(shù)據(jù)概述,我們通過DataKeys集合來獲取給定item的主鍵。這個(gè)方法在DataList里很好用,但是Repeater沒有DataKeys屬性。因此我們需要換一種方法來提供主鍵的值,比如通過button的 CommandArgument,或者在template使用一個(gè)隱藏的Label,然后通過e.Item.FindControl("LabelID")在ItemCommand event handler里讀出它的值。
完成ItemCommand event handler后,瀏覽該頁(yè)。見圖7。點(diǎn)“Show Products” link會(huì)引起postback,并顯示相關(guān)的products。而且,注意當(dāng)點(diǎn)其它“Show Products” links時(shí)前面的product信息會(huì)保留。
注意:如果你需要修改這個(gè)報(bào)表的行為,比如一次只列出一個(gè)category的products,僅僅只需要將BulletedList的EnableViewState屬性設(shè)為False。
圖 7: 用 BulletedList 顯示選擇Category關(guān)聯(lián)的 Products.
總結(jié)
DataList和Repeater可以在templates里包含很多Buttons, LinkButtons, ImageButtons。這些button被點(diǎn)時(shí)會(huì)引起postback,并激發(fā)ItemCommand事件。為ItemCommand event.創(chuàng)建一個(gè)event handler可以將服務(wù)器端代碼和點(diǎn)擊button關(guān)聯(lián)起來。在這個(gè)event handler里首先檢查傳入的CommandName的值來判斷是哪個(gè)button被點(diǎn)了。其它另外的信息可以通過CommandArgument屬性來提供。
祝編程快樂!
作者簡(jiǎ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ù)教程》,希望對(duì)大家的學(xué)習(xí)ASP.NET有所幫助。
- 讓W(xué)in2008+IIS7+ASP.NET支持10萬并發(fā)請(qǐng)求
- c#實(shí)現(xiàn)服務(wù)器性能監(jiān)控并發(fā)送郵件保存日志
- C#線程執(zhí)行超時(shí)處理與并發(fā)線程數(shù)控制實(shí)例
- c#編寫的高并發(fā)數(shù)據(jù)庫(kù)控制訪問代碼
- C#使用隊(duì)列(Queue)解決簡(jiǎn)單的并發(fā)問題
- 在ASP.NET 2.0中操作數(shù)據(jù)之二十一:實(shí)現(xiàn)開放式并發(fā)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十四:DataList和Repeater數(shù)據(jù)排序(三)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十六:使用SqlDataSource控件檢索數(shù)據(jù)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十七:用SqlDataSource控件插入、更新、刪除數(shù)據(jù)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十八:對(duì)SqlDataSource控件使用開放式并發(fā)
相關(guān)文章
在ASP.NET 2.0中操作數(shù)據(jù)之四十七:用SqlDataSource控件插入、更新、刪除數(shù)據(jù)
本文主要介紹使用SqlDataSource控件完成插入、更新、刪除數(shù)據(jù)等操作,通過設(shè)置向?qū)?,SqlDataSource控件的InsertCommand, UpdateCommand和DeleteCommand屬性都會(huì)被賦以相應(yīng)的 INSERT, UPDATE和DELETE SQL語句,從而實(shí)現(xiàn)相應(yīng)的操作。2016-05-05.Net?Core微服務(wù)網(wǎng)關(guān)Ocelot基礎(chǔ)介紹及集成
這篇文章介紹了.Net?Core微服務(wù)網(wǎng)關(guān)Ocelot基礎(chǔ)及集成,對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-01-01在ASP.NET 2.0中操作數(shù)據(jù)之五十三:在Data Web控件顯示二進(jìn)制數(shù)據(jù)
本文主要介紹在ASP.NET 2.0中直接顯示PDF超鏈接的方法,以及如何把已二進(jìn)制數(shù)據(jù)形式保存的圖片顯示在GridView中的方法,雖然這種方法在實(shí)際開發(fā)中很少用,但還是值得學(xué)習(xí)一下。2016-05-05ASP.NET MVC4入門教程(七):給電影表和模型添加新字段
本文使用Entity Framework Code First來實(shí)現(xiàn)模型類上的操作,使用代碼優(yōu)先的模式,從而使得直接修改代碼,數(shù)據(jù)庫(kù)也會(huì)做相應(yīng)的改變。2016-04-04在ASP.NET 2.0中操作數(shù)據(jù)之五十:為GridView控件添加Checkbox
本文主要介紹ASP.NET 2.0中為GridView控件添加Checkbox復(fù)選框控件的方法,并實(shí)現(xiàn)全選功能。2016-05-05在ASP.NET 2.0中操作數(shù)據(jù)之七十三:用Managed Code創(chuàng)建存儲(chǔ)過程和用戶自定義函數(shù)(上部分)
Microsoft SQL Server 2005整合了Common Language Runtime (CLR),它允許用managed code來創(chuàng)建數(shù)據(jù)庫(kù)對(duì)象,本文主要介紹了如何使用managed code創(chuàng)建存儲(chǔ)過程。2016-05-05Microsoft .Net Remoting系列教程之一:.Net Remoting基礎(chǔ)篇
本文主要講解.Net Remoting的基礎(chǔ),需要的朋友可以參考下。2016-05-05解讀ASP.NET 5 & MVC6系列教程(17):MVC中的其他新特性
這篇文章主要介紹了ASP.NET 5中全局導(dǎo)入、獲取IP相關(guān)信息、文件上傳等其他新特性,需要的朋友可以參考下2016-06-06