導(dǎo)言

　　在前面的教程里我們學(xué)習(xí)了DataList提供了一些風(fēng)格樣式的屬性.而且我們還學(xué)習(xí)了如何定義HeadStyle, ItemStyle, AlternatingItemStyle, 和SelectedItemStyle等屬性的默認(rèn)CSS.除了這四個(gè)屬性外,DataList還提供了其它屬性,比如Font, ForeColor, BackColor, 和BorderWidth.而Repeater沒有提供任何這樣的屬性.如果你需要用Reperter來(lái)實(shí)現(xiàn)這些效果,你就需要在templates里直接寫標(biāo)記語(yǔ)言.

　　通常,數(shù)據(jù)需要怎樣的格式取決于數(shù)據(jù)本身.比如,我們可能使用灰色的字體列出那些被停止使用的product,或者在UnitsInStock等于0的時(shí)候顯示高亮.前面的教程里我們已經(jīng)學(xué)習(xí)了GridView, DetailsView, 和FormView 都提供了兩種截然不同的格式化數(shù)據(jù)的方法.

　　DataBound 事件— 為DataBound 事件創(chuàng)建一個(gè)合適的event handler, 它在數(shù)據(jù)綁定到item的時(shí)候激發(fā)(對(duì)GridView來(lái)說是RowDataBound 事件; 對(duì) DataList 和Repeater來(lái)說是 ItemDataBound 事件). 在這些事件里, 剛剛綁定的數(shù)據(jù)可以被格式化. 參見《基于數(shù)據(jù)的自定義格式化》 這章.

　　Templates 的格式化功能— 在DetailsView 或GridView 里使用TemplateFields , 或 在FormView 里使用template , 我們可以在ASP.NET page的code-behind class里或者BLL里,或者任何其它web程序里可以調(diào)用的類庫(kù)里加格式化信息. 這種格式化功能可以接收任意的輸入?yún)?shù), 但是在template里比如返回HTML . 格式化功能最早在在GridView控件中使用TemplateField 這章里談到過. 這兩種方法都可以在DataList和Repeater里使用.在本章里我們將一步步用這兩種方法在這兩個(gè)控件里做示例.

使用 ItemDataBound Event Handler

　　當(dāng)數(shù)據(jù)綁定到 DataList時(shí), 無(wú)論是使用數(shù)據(jù)源控件或者 直接在代碼里使用DataSource 和 DataBind() , DataList的DataBinding 事件都會(huì)被激發(fā).  DataList 為數(shù)據(jù)源的每條記錄創(chuàng)建一個(gè) DataListItem 對(duì)象,然后綁定到當(dāng)前記錄. 在這個(gè)過程中DataList 激發(fā)兩個(gè)事件:

ItemCreated — 在創(chuàng)建DataListItem 后激發(fā)
ItemDataBound — 當(dāng)前記錄綁定到DataListItem 后激發(fā)

下面列出了DataList數(shù)據(jù)綁定過程的大概步驟

DataList的DataBinding event 被激發(fā)
DataList
對(duì)數(shù)據(jù)源的每條記錄...
For each record in the data source…
創(chuàng)建一個(gè)DataListItem 對(duì)象
激發(fā)ItemCreated event
綁定記錄到DataListItem
激發(fā)ItemDataBound event
將DataListItem 添加到Items collection

　　當(dāng)數(shù)據(jù)綁定到Repeater時(shí),和上面所說的情況一樣.唯一的區(qū)別在于,DataListItem換成了RepeaterItem.

　　注意:細(xì)心的讀者可能注意到了DataList和Repeater綁定到數(shù)據(jù)時(shí)的步驟順序和GridView有些許差別.在數(shù)據(jù)綁定過程的后期,GridView會(huì)激發(fā)DataBound事件,而DataList和Repeater則都沒有這個(gè)事件.

　　和GridView一樣,可以為ItemDataBound事件創(chuàng)建一個(gè)event handler 來(lái)格式化數(shù)據(jù).這個(gè)event handler 可以處理剛剛綁定到DataListItem或RepeaterItem的數(shù)據(jù),來(lái)按照需要進(jìn)行格式化.

　　對(duì)DataList來(lái)說,可以使用風(fēng)格樣式相關(guān)的屬性,如Font, ForeColor, BackColor, CssClass等,來(lái)格式化item.而如果你想格式化Datalist里的template里的web控件,你需要編程去獲取這些控件,然后來(lái)控制.我們?cè)凇禖ustom Formatting Based Upon Data》里已經(jīng)看過怎樣做.和Repeater控件一樣,RepeaterItem類也沒有風(fēng)格樣式相關(guān)的屬性,因此,你需要在ItemDataBound event handler里編程去實(shí)現(xiàn).

由于在DataList和Repeater里使用ItemDataBound格式化技術(shù)從本質(zhì)上來(lái)說是由于的,因此我們的示例主要講DataList.

第一步: 在DataList顯示Product  信息

　　在學(xué)習(xí)格式化之前,我們首先創(chuàng)建一個(gè)使用DataList顯示product信息的頁(yè)面.在前面一章里,我們創(chuàng)建了一個(gè)ItemTemplate顯示product 的name,category, supplier, quantity和price的DataList.我們?cè)诒菊聛?lái)重復(fù)做一次.你可以重新創(chuàng)建DataList和它的ObjectDataSource ,或者直接把前面一章里的Basics.aspx里的控件復(fù)制到本章的頁(yè)面(Formatting.aspx)里.當(dāng)你完成了Formatting.aspx后,將DataList的ID從DataList1改為ItemDataBoundFormattingExample.下面,在瀏覽器里看看DataList.如圖1所示,唯一的格式在于每個(gè)product的交替的背景色.

圖 1: 在DataList 里列出product信息

在本章教程里,我們來(lái)將價(jià)格小于 $20.00 的product的名字和單價(jià)用黃色 高亮來(lái)顯示.

第二步: 在 ItemDataBound Event Handler里編程判斷數(shù)據(jù)的值

　　由于只有價(jià)格低于$20.00 的product會(huì)被格式化,因此我們首先要判斷每個(gè)product的價(jià)格.在綁定數(shù)據(jù)到DataList時(shí),DataList 為每條數(shù)據(jù)源的記錄創(chuàng)建一個(gè)DataListItem實(shí)例,并綁定數(shù)據(jù).當(dāng)記錄綁定到DataListItem對(duì)象后,ItemDataBound事件被激發(fā).我們可以為這個(gè)事件創(chuàng)建一個(gè)event handler來(lái)判斷當(dāng)前DataListItem的值,再根據(jù)這個(gè)值來(lái)格式化數(shù)據(jù).
添加以下代碼為DataList創(chuàng)建ItemDataBound事件

protected void ItemDataBoundFormattingExample_ItemDataBound
 (object sender, DataListItemEventArgs e)
{
 if (e.Item.ItemType == ListItemType.Item ||
 e.Item.ItemType == ListItemType.AlternatingItem)
 {
 // Programmatically reference the ProductsRow instance bound
 // to this DataListItem
 Northwind.ProductsRow product =
  (Northwind.ProductsRow)((System.Data.DataRowView)e.Item.DataItem).Row;
 // See if the UnitPrice is not NULL and less than $20.00
 if (!product.IsUnitPriceNull()  product.UnitPrice  20)
 {
  // TODO: Highlight the product's name and price
 }
 }
}

　　DataList的ItemDataBound event handler在概念和語(yǔ)義上來(lái)說,和GridView的RowDataBound event handler一樣(見基于數(shù)據(jù)的自定義格式化),語(yǔ)法上有一點(diǎn)差別.當(dāng)ItemDataBound事件激發(fā)時(shí),剛剛綁定數(shù)據(jù)的DataListItem通過e.Item(在GridView里是e.Row和RowDataBound)傳遞給相關(guān)的event handler.DataList的ItemDataBound event handler影響到每一行,包括 header ， footer 和separator.但是product信息只綁定到data行.因此,在處理ItemDataBound事件前,我們首先要判斷處理的是否是data行.這個(gè)可以通過檢查DataListItem的ItemType 屬性來(lái)完成,它可以有以下八個(gè)值:

AlternatingItem
EditItem
Footer
Header
Item
Pager
SelectedItem
Separator

　　Item和AlternatingItem都表示DataList的data item.假設(shè)我們?cè)谔幚鞩tem或AlternatingItem,我們可以獲取綁定到當(dāng)前DataListItem的ProductsRow的實(shí)例.DataListItem的DataItem屬性包含了DataRowView對(duì)象的引用,通過它的Row屬性可以獲取ProductsRow對(duì)象.

　　下面我們來(lái)檢查ProductsRow實(shí)例的單價(jià)屬性.由于Product表的UnitPrice字段允許空值,所以在獲取UnitPrice屬性前我們應(yīng)該先用IsUnitPriceNull()方法檢查這個(gè)值是否為空.如果不是,我們?cè)贆z查看它是否低于$20.00.如果是,我們就進(jìn)行格式化處理.

第三步: 是Product的 Name 和Price高亮顯示

　　一旦我們發(fā)現(xiàn)Product的price低于$20.00,我們將使它的name和price顯示高亮.首先我們要編程獲得ItemTemplate里顯示Product的name和price的Label控件.然后我們將它的背景色顯示為黃色.這個(gè)可以直接通過修改Label空間的BackColor屬性(LabelID.BackColor = Color.Yellow).當(dāng)然最理想的做法是所有的顯示相關(guān)的行為都通過CSS來(lái)實(shí)現(xiàn).實(shí)際上我們?cè)诨跀?shù)據(jù)的自定義格式化一章里創(chuàng)建的Styles.css - AffordablePriceEmphasis已經(jīng)提供了這個(gè)功能.

使用以下代碼設(shè)置兩個(gè)Label控件的CssClass 屬性為AffordablePriceEmphasis來(lái)完成格式化:

// Highlight the product name and unit price Labels
// First, get a reference to the two Label Web controls
Label ProductNameLabel = (Label)e.Item.FindControl("ProductNameLabel");
Label UnitPriceLabel = (Label)e.Item.FindControl("UnitPriceLabel");
// Next, set their CssClass properties
if (ProductNameLabel != null)
 ProductNameLabel.CssClass = "AffordablePriceEmphasis";
if (UnitPriceLabel != null)
 UnitPriceLabel.CssClass = "AffordablePriceEmphasis";

ItemDataBound 事件完成后,在瀏覽器里瀏覽Formatting.aspx頁(yè).如圖2所示,價(jià)格低于 $20.00 的product的name和prict都高亮顯示了.

圖2: 價(jià)格低于$20.00 的product都被高亮顯示

　　注意:由于DataList使用 HTML table>, DataListItem實(shí)例有可以設(shè)置整個(gè)item風(fēng)格的屬性.比如,如果我們想在price低于$20.00時(shí)將所有的item都用黃色來(lái)高亮顯示,我們可以用e.Item.CssClass = "AffordablePriceEmphasis"來(lái)代替上面的代碼(見圖3).

　　而組成Repeater的RepeaterItem并沒有提供這樣的屬性.因此,在Repeater里自定義格式需要設(shè)置templates里的控件的格式,象在圖2里所做的那樣.

圖 3: The Entire Product Item is Highlighted for Products Under $20.00

使用 Template的格式化功能

　　在在GridView控件中使用TemplateField 一章里,我們學(xué)習(xí)了如何使用GridView TemplateField的格式化功能來(lái)格式化GridView的數(shù)據(jù).格式化功能是一種可以從template里調(diào)用并返回HTML顯示的方法.格式化功能可以寫在ASP.NET page的 code-behind class 或App_Code 文件夾里的類文件里或單獨(dú)的類庫(kù)項(xiàng)目里.如果你想在其它ASP.NET web程序或多個(gè)ASP.NET 頁(yè)用到同樣的功能,那么不要把它下在ASP.NET page的 code-behind class 里.

　　為了演示這個(gè)功能,我們將修改product信息.如果product被停用,我們?cè)趐roduct的name后面增加一個(gè)“[DISCONTINUED]”的text.同樣的,如果price低于 $20.00 我們將會(huì)用黃色來(lái)高亮顯示(如我們?cè)贗temDataBound event handler例子里做的那樣).如果price等于或高于 $20.00,我們將不顯示實(shí)際的價(jià)格,而是在text里顯示“Please call for a price quote”. 圖4是完成以上功能的頁(yè)面截圖.

圖 4: 將比較貴的Products 的價(jià)格用文本“Please call for a price quote”來(lái)代替.

第一步: 創(chuàng)建格式化功能

　　這個(gè)例子里我們需要兩個(gè)格式化功能,其一是在被停用的product name后面加上“[DISCONTINUED]”, 其二是對(duì)價(jià)格低于$20.00的product高亮顯示,其它則顯示“Please call for a price quote”.我們將在ASP.NET page的code-behind class 里創(chuàng)建這些功能,并給它們?nèi)∶麨镈isplayProductNameAndDiscontinuedStatus 和DisplayPrice.這兩個(gè)方法都需要返回HTML,而且為了在ASP.NET page的聲明語(yǔ)法里調(diào)用,都需要標(biāo)記為Protected (or Public).下面是這兩個(gè)方法的代碼:

protected string DisplayProductNameAndDiscontinuedStatus
 (string productName, bool discontinued)
{
 // Return just the productName if discontinued is false
 if (!discontinued)
  return productName;
 else
  // otherwise, return the productName appended with the text "[DISCONTINUED]"
  return string.Concat(productName, " [DISCONTINUED]");
}
protected string DisplayPrice(Northwind.ProductsRow product)
{
 // If price is less than $20.00, return the price, highlighted
 if (!product.IsUnitPriceNull()  product.UnitPrice  20)
  return string.Concat("span class=\"AffordablePriceEmphasis\">",
        product.UnitPrice.ToString("C"), "/span>");
 else
  // Otherwise return the text, "Please call for a price quote"
  return "span>Please call for a price quote/span>";
}

　　注意到DisplayProductNameAndDiscontinuedStatus 方法接收productName 和discontinued 的值.而DisplayPrice 方法接收ProductsRow (而不是UnitPrice).如果格式化功能處理可能包含數(shù)據(jù)庫(kù)空值(比如UnitPrice,而ProductName和Discontinued都不允許空)的量值,要特別小心處理.

　　輸入的值可能是一個(gè)DBNull而不是你期望的數(shù)據(jù)類型,因此輸入?yún)?shù)的類型必須為Object.而且比如檢查傳進(jìn)來(lái)的值是否為database NULL.也就是說,如果我們想讓DisplayPrice 方法以價(jià)格為參數(shù),我們需要以下代碼:

protected string DisplayPrice(object unitPrice)
{
 // If price is less than $20.00, return the price, highlighted
 if (!Convert.IsDBNull(unitPrice)  ((decimal) unitPrice)  20)
  return string.Concat("span class=\"AffordablePriceEmphasis\">",
        ((decimal) unitPrice).ToString("C"), "/span>");
 else
  // Otherwise return the text, "Please call for a price quote"
  return "span>Please call for a price quote/span>";
}

注意輸入?yún)?shù)UnitPrice的類型為Object,條件判斷語(yǔ)句被修改為判斷unitPrice 是否為DBNull.而且,由于UnitPrice是作為Object傳進(jìn)來(lái)的,所以必須要類型轉(zhuǎn)換為decimal.

第二步: 在DataList 的ItemTemplate調(diào)用格式化方法

在完成以上代碼后,剩下的工作就是在DataList的ItemTemplate里調(diào)用這些格式化功能.我們需要使用以下代碼:

%# MethodName(inputParameter1, inputParameter2, ...) %>

　　在DataList的ItemTemplate里,ProductNameLabel Label通過指定text屬性為%# Eval("ProductName") %>顯示的product的name.為了在需要的情況下加上“[DISCONTINUED]” ,修改代碼,使用DisplayProductNameAndDiscontinuedStatus 方法來(lái)指定text屬性.我們需要使用Eval("columnName") 語(yǔ)法來(lái)將product的name和discontinued的值傳進(jìn)去.Eval 返回的值為Object類型,而DisplayProductNameAndDiscontinuedStatus 的參數(shù)為String 和Boolean.因此,我們需要將Eval 方法返回的值轉(zhuǎn)換為需要的參數(shù)類型,代碼如下:

h4>
 asp:Label ID="ProductNameLabel" runat="server"
  Text='%# DisplayProductNameAndDiscontinuedStatus((string) Eval("ProductName"),
    (bool) Eval("Discontinued")) %>'>
 /asp:Label>
/h4>

和顯示product的name和“[DISCONTINUED]” 文本一樣,我們?cè)O(shè)置UnitPriceLabel label的屬性為DisplayPrice 的返回值來(lái)顯示價(jià)格.我們將ProductsRow作為參數(shù),而不是UnitPrice:

asp:Label ID="UnitPriceLabel" runat="server"
 Text='%# DisplayPrice((Northwind.ProductsRow)
   ((System.Data.DataRowView) Container.DataItem).Row) %>'>
/asp:Label>

完成以上代碼后，在瀏覽器里看一下頁(yè)面.你的頁(yè)面應(yīng)該和圖5看起來(lái)差不多.

圖 5: 將比較貴的Products 的價(jià)格用文本“Please call for a price quote”來(lái)代替

總結(jié)

　　基于數(shù)據(jù)格式化DataList或Repeater有兩種方法.一種是為ItemDataBound 創(chuàng)建event handler .ItemDataBound 在數(shù)據(jù)源的每條記錄綁定到DataListItem 或RepeaterItem時(shí)被激發(fā).在ItemDataBound  event handler里,可以判斷當(dāng)前item的數(shù)據(jù)并格式化,而對(duì)DataListItem可以格式化整個(gè)item.

　　另一種是通過格式化功能來(lái)完成自定義格式化.格式化功能是一種可以從template里調(diào)用并返回HTML顯示的方法.通常,通過判斷綁定到當(dāng)前item的值來(lái)決定返回什么樣的HTML.這些值或者綁定到item的對(duì)象可以傳遞到格式化功能里.祝編程快樂!

作者簡(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，也可以通過他的博客http://scottonwriting.net/與他聯(lián)系。