導(dǎo)言

　　DataList的編輯界面由EditItemTemplate里的標(biāo)記語言和web控件定義。在目前為止所做的DataList編輯功能的例子里，編輯界面都只包含TextBox。在前面一章里，我們通過添加驗(yàn)證控件來增加了用戶體驗(yàn)，提高了可用性。

　　EditItemTemplate可以包含除了TextBox以外的很多控件，比如DropDownList, RadioButtonList, Calendar等。和使用TextBox一樣，使用這些控件自定義編輯界面時(shí)，步驟如下：

為EditItemTemplate添加控件.
使用綁定語法將相關(guān)的字段值賦給控件的屬性.
在UpdateCommand事件處理里, 編程訪問web控件的值，并將它傳給相關(guān)的BLL的方法.

　　本章我們將為DataList創(chuàng)建一個(gè)更豐富的編輯界面，它將包含DropDownList和CheckBox。我們將創(chuàng)建一個(gè)列出product信息的DataList，用戶可以更新它的name，supplier，category和discontinued status。見圖1。

圖 1: 編輯界面包含一個(gè)TextBox, 兩個(gè) DropDownLists和一個(gè)CheckBox

第一步: 顯示Product 信息

　　在創(chuàng)建DataList的編輯界面前，我們需要先創(chuàng)建一個(gè)只讀界面。先打開EditDeleteDataList文件夾下的CustomizedUI.aspx頁，拖一個(gè)DataList進(jìn)來，將ID設(shè)為Products。通過DataList的智能標(biāo)簽，創(chuàng)建一個(gè)名為ProductsDataSource的ObjectDataSource，用ProductsBLL類的GetProducts方法配置它。象前面一章一樣，我們將直接通過BLL來更新product信息。在UPDATE,INSERT,DELETE標(biāo)簽里選擇None.

圖 2: 在UPDATE, INSERT, DELETE 標(biāo)簽的下拉列表里選擇 (None)

　　配置完ObjectDataSource后，Visual Studio會(huì)自動(dòng)創(chuàng)建默認(rèn)的ItemTemplate，列出每個(gè)字段的值。將product name用h4>表示，并添加一個(gè)Edit button，確保將它的CommandName屬性設(shè)為 “Edit”. 我的標(biāo)記語言如下：

ItemTemplate>
 h4>
  asp:Label ID="ProductNameLabel" runat="server"
   Text='%# Eval("ProductName") %>' />
 /h4>
 table border="0">
  tr>
   td class="ProductPropertyLabel">Category:/td>
   td class="ProductPropertyValue">
    asp:Label ID="CategoryNameLabel" runat="server"
     Text='%# Eval("CategoryName") %>' />
   /td>
   td class="ProductPropertyLabel">Supplier:/td>
   td class="ProductPropertyValue">
    asp:Label ID="SupplierNameLabel" runat="server"
     Text='%# Eval("SupplierName") %>' />
   /td>
  /tr>
  tr>
   td class="ProductPropertyLabel">Discontinued:/td>
   td class="ProductPropertyValue">
    asp:Label ID="DiscontinuedLabel" runat="server"
     Text='%# Eval("Discontinued") %>' />
   /td>
   td class="ProductPropertyLabel">Price:/td>
   td class="ProductPropertyValue">
    asp:Label ID="UnitPriceLabel" runat="server"
     Text='%# Eval("UnitPrice", "{0:C}") %>' />
   /td>
  /tr>
  tr>
   td colspan="4">
    asp:Button runat="Server" ID="EditButton"
     Text="Edit" CommandName="Edit" />
   /td>
  /tr>
 /table>
 br />
/ItemTemplate>

　　上面的標(biāo)記語言用h4>表示product name，4列的table>展示其它字段。前面已經(jīng)討論過Styles.css里定義的ProductPropertyLabel和productPropertyValue類。瀏覽該頁，見圖3。

圖 3: 顯示product信息

第二步: 為編輯界面添加web控件

　　首先向EditItemTemplate里添加需要的web控件。我們需要用一個(gè)DropDownList表示category，一個(gè)DropDownList表示supplier，一個(gè)CheckBox 表示discontinued state。由于本例中不用編輯price，所以仍然用Label來表示它。

　　點(diǎn)擊DataList的智能標(biāo)簽上的“Edit Templates”，選擇EditItemTemplate,為它添加一個(gè)ID為Categories的EditItemTemplate。

圖 4: 為Categories添加一個(gè)DropDownList

　　然后從DropDownList的智能標(biāo)簽里選擇“Choose Data Source”，創(chuàng)建一個(gè)名為CategoriesDataSource的ObjectDataSource。用CategoriesBLL類的GetCategories()方法配制它（見圖5）。數(shù)據(jù)源配置向?qū)?huì)要求為L(zhǎng)istItem Text和Value選擇字段。讓DropDownList 顯示CategoryName，CategoryID作為Value,見圖6。

圖 5: 創(chuàng)建 ObjectDataSource

圖 6: 配置DropDownList的 Display 字段和Value 字段

　　重復(fù)上面的步驟，為suppliers創(chuàng)建一個(gè)ID為Suppliers的DropDownList 和一個(gè)名為SuppliersDataSource的ObjectDataSource。

　　然后為discontinued state 添加一個(gè)CheckBox ，為name添加一個(gè)TextBox 。將他們的ID分別設(shè)為Discontinued和ProductName。為product name添加一個(gè)RequiredFieldValidator 確保用戶必須提供這個(gè)值。

　　最后添加Update 和Cancel button。記得這兩個(gè)button的CommandName屬性必須分別設(shè)為“Update” 和“Cancel”。你可以將編輯界面以你喜歡的方式展示。我選擇使用和只讀界面一樣的界面來顯示，見下面的聲明代碼和截圖。

EditItemTemplate>
 h4>
  asp:Label ID="ProductNameLabel" runat="server"
   Text='%# Eval("ProductName") %>' />
 /h4>
 table border="0">
  tr>
   td class="ProductPropertyLabel">Name:/td>
   td colspan="3" class="ProductPropertyValue">
    asp:TextBox runat="server" ID="ProductName" Width="90%" />
    asp:RequiredFieldValidator ID="RequiredFieldValidator1"
     ControlToValidate="ProductName"
     ErrorMessage="You must enter a name for the product."
     runat="server">*/asp:RequiredFieldValidator>
   /td>
  /tr>
  tr>
   td class="ProductPropertyLabel">Category:/td>
   td class="ProductPropertyValue">
    asp:DropDownList ID="Categories" runat="server"
     DataSourceID="CategoriesDataSource"
     DataTextField="CategoryName" DataValueField="CategoryID" />
   /td>
   td class="ProductPropertyLabel">Supplier:/td>
   td class="ProductPropertyValue">
    asp:DropDownList ID="Suppliers" DataTextField="CompanyName"
     DataSourceID="SuppliersDataSource"
     DataValueField="SupplierID" runat="server" />
   /td>
  /tr>
  tr>
   td class="ProductPropertyLabel">Discontinued:/td>
   td class="ProductPropertyValue">
    asp:CheckBox runat="server" id="Discontinued" />
   /td>
   td class="ProductPropertyLabel">Price:/td>
   td class="ProductPropertyValue">
    asp:Label ID="UnitPriceLabel" runat="server"
     Text='%# Eval("UnitPrice", "{0:C}") %>' />
   /td>
  /tr>
  tr>
   td colspan="4">
    asp:Button runat="Server" ID="UpdateButton" CommandName="Update"
     Text="Update" />
     
    asp:Button runat="Server" ID="CancelButton" CommandName="Cancel"
     Text="Cancel" CausesValidation="False" />
   /td>
  /tr>
 /table>
 br />
 asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
  OldValuesParameterFormatString="original_{0}" SelectMethod="GetCategories"
  TypeName="CategoriesBLL">
 /asp:ObjectDataSource>
 asp:ObjectDataSource ID="SuppliersDataSource" runat="server"
  OldValuesParameterFormatString="original_{0}" SelectMethod="GetSuppliers"
  TypeName="SuppliersBLL">
 /asp:ObjectDataSource>
/EditItemTemplate>

圖 7: 編輯界面和只讀界面的展示差不多

第三步: 創(chuàng)建 EditCommand和CancelCommand Event Handlers

　　現(xiàn)在在EditItemTemplate里除了UnitPriceLabel外還沒有綁定語法（從ItemTemplate復(fù)制過來的代碼）。在添加綁定語法前我們首先為DataList的EditCommand和CancelCommand創(chuàng)建事件處理。EditCommand事件處理的目標(biāo)是為了將Edit button被點(diǎn)擊的item展示為編輯狀態(tài)，而CancelCommand的目標(biāo)是將DataList返回到編輯前狀態(tài)。見下面的代碼：

protected void Products_EditCommand(object source, DataListCommandEventArgs e)
{
 // Set the DataList's EditItemIndex property and rebind the data
 Products.EditItemIndex = e.Item.ItemIndex;
 Products.DataBind();
}
protected void Products_CancelCommand(object source, DataListCommandEventArgs e)
{
 // Return to DataList to its pre-editing state
 Products.EditItemIndex = -1;
 Products.DataBind();
}

　　完成這些后，點(diǎn)擊Edit button會(huì)進(jìn)入編輯界面，點(diǎn)擊Cancel button會(huì)返回只讀模式。見圖8。由于現(xiàn)在還沒有為編輯界面添加綁定語法，TextBox是空白的，CheckBox 未被選中，兩個(gè)DropDownList里都是第一個(gè)item被選中。

圖 8: 點(diǎn)擊Edit Button顯示編輯界面

第四步: 為編輯界面增加綁定語法

　　為了讓編輯界面顯示當(dāng)前product的值，我們需要使用綁定語法將字段的值賦給web控件。綁定語法可以通過選擇web控件的智能標(biāo)簽的“Edit DataBindings”或者直接添加聲明語法來實(shí)現(xiàn)。

　　將ProductName字段的值賦給ProductName TextBox的Text屬性，CategoryID和SupplierID字段賦給Categories和Suppliers DropDownList的SelectedValue屬性，Discontinued字段賦給Discontinued CheckBox的Checked屬性。完成這些后，瀏覽頁面并點(diǎn)擊Edit button.見圖9。

圖 9: 點(diǎn)擊Edit Button 顯示編輯界面

第五步: 在UpdateCommand Event Handler保存用戶的更改

　　當(dāng)用戶編輯product并點(diǎn)Update button后，會(huì)postback并激發(fā)UpdateCommand事件。在事件處理里，我們需要從EditItemTemplate里讀出web控件的值，并和BLL交互，然后更新數(shù)據(jù)庫里的product。如我們?cè)谇懊嬉徽驴吹降哪菢樱桓碌膒roduct的ProductID可以通過DataKeys集合來獲取。用戶輸入的值可以通過FindControl("controlID")來編程獲取，見下面的代碼：

protected void Products_UpdateCommand(object source, DataListCommandEventArgs e)
{
 // Make sure the page is valid...
 if (!Page.IsValid)
  return;
 // Read in the ProductID from the DataKeys collection
 int productID = Convert.ToInt32(Products.DataKeys[e.Item.ItemIndex]);
 // Read in the product name and price values
 TextBox productName = (TextBox)e.Item.FindControl("ProductName");
 DropDownList categories = (DropDownList)e.Item.FindControl("Categories");
 DropDownList suppliers = (DropDownList)e.Item.FindControl("Suppliers");
 CheckBox discontinued = (CheckBox)e.Item.FindControl("Discontinued");
 string productNameValue = null;
 if (productName.Text.Trim().Length > 0)
  productNameValue = productName.Text.Trim();
 int categoryIDValue = Convert.ToInt32(categories.SelectedValue);
 int supplierIDValue = Convert.ToInt32(suppliers.SelectedValue);
 bool discontinuedValue = discontinued.Checked;
 // Call the ProductsBLL's UpdateProduct method...
 ProductsBLL productsAPI = new ProductsBLL();
 productsAPI.UpdateProduct(productNameValue, categoryIDValue, supplierIDValue,
        discontinuedValue, productID);
 // Revert the DataList back to its pre-editing state
 Products.EditItemIndex = -1;
 Products.DataBind();
}

　　代碼首先檢查Page.IsValid屬性來確保所有的驗(yàn)證控件都返回合法值。如果Page.IsValid為True，從DataKeys集合里讀出被編輯的product 的ProductID的值，并引用EditItemTemplate里的web控件。然后將這些控件的值讀到變量里，并傳給UpdateProduct方法。完成更新后，DataList會(huì)返回到編輯前的狀態(tài)。

　　注意：我省略了某章異常處理，目的是為了使本章的代碼看起來目的性更強(qiáng)。你可以在完成本章后自己添加異常處理的功能作為練習(xí)。

第六步: 處理空的CategoryID 和SupplierID 值

　　Northwind 數(shù)據(jù)庫允許Products表里的CategoryID和SupplierID列為空。然而我們的編輯界面目前還沒有提供可選空值。如果我們?cè)噲D編輯一個(gè)無論是CategoryID還是SupplierID為空的product，將會(huì)產(chǎn)生ArgumentOutOfRangeException異常。目前我們也沒有將product的category或supplier的值從一個(gè)非空值轉(zhuǎn)換為空值的方法。

　　為了在DropDownLists里添加空值，我們需要添加一個(gè)ListItem。我將ListItem里的Text顯示為"(None)"，你可以將它賦為任何你希望的值（比如空字符串）。最后，記得將DropDownLists的AppendDataBoundItems設(shè)為True。如果你沒有這么做，綁定到DropDownList 的categories 和suppliers 會(huì)被添加的ListItem覆蓋。完成這些后，DropDownLists的標(biāo)記語言看起來應(yīng)該和下面差不多：

asp:DropDownList ID="Categories" DataSourceID="CategoriesDataSource"
 DataTextField="CategoryName" DataValueField="CategoryID" runat="server"
 SelectedValue='%# Eval("CategoryID") %>' AppendDataBoundItems="True">
 asp:ListItem Value=" Selected="True">(None)/asp:ListItem>
/asp:DropDownList>
...
asp:DropDownList ID="Suppliers" DataSourceID="SuppliersDataSource"
 DataTextField="CompanyName" DataValueField="SupplierID" runat="server"
 SelectedValue='%# Eval("SupplierID") %>' AppendDataBoundItems="True">
 asp:ListItem Value=" Selected="True">(None)/asp:ListItem>
/asp:DropDownList>

　　注意：為DropDownList 添加ListItems可以通過設(shè)計(jì)器或者聲明語法來完成。當(dāng)添加一個(gè)表示數(shù)據(jù)庫空值的item時(shí)，要確保是通過聲明語法來完成的。如果你使用設(shè)計(jì)器的ListItem集合編輯器，當(dāng)賦空字符串時(shí)，產(chǎn)生的聲明語法會(huì)忽略Value的設(shè)置，產(chǎn)生想asp:ListItem>(None)/asp:ListItem>這樣的語句。這個(gè)看起來并沒有什么關(guān)系，但是缺少Value會(huì)讓DropDownList 使用Text屬性的值作為Value。這意味著當(dāng)NULL  ListItem被選擇時(shí)，“(None)” 會(huì)被賦給product的CategoryID或SupplierID字段，這會(huì)引起異常。而顯式的將Value設(shè)為“”，當(dāng)NULL  ListItem被選擇時(shí)一個(gè)空值會(huì)被賦給product的CategoryID或SupplierID字段。現(xiàn)在瀏覽該頁。當(dāng)編輯product時(shí)，注意Categories和Suppliers DropDownLists 開頭都包含一個(gè)“(None)”選項(xiàng)。

圖 10: Categories 和Suppliers DropDownLists包含 “(None)”

　　為了將“(None)” 保存為數(shù)據(jù)庫NULL值，我們需要回到UpdateCommand事件處理。將categoryIDValue和supplierIDValue變量設(shè)為可為空的整型，并在DropDownList的SelectedValue的值不為空字符串時(shí)才為它們賦值。

int? categoryIDValue = null;
if (!string.IsNullOrEmpty(categories.SelectedValue))
 categoryIDValue = Convert.ToInt32(categories.SelectedValue);
int? supplierIDValue = null;
if (!string.IsNullOrEmpty(suppliers.SelectedValue))
 supplierIDValue = Convert.ToInt32(suppliers.SelectedValue);

　　完成這個(gè)后，如果用戶在DropDownList里選擇“(None)” 時(shí)，一個(gè)空值將被傳給UpdateProduct BLL方法，它相當(dāng)于數(shù)據(jù)庫的NULL值。

總結(jié)

　　本章我們學(xué)習(xí)了如何為DataList創(chuàng)建一個(gè)更復(fù)雜的編輯界面，它包含三種不同的web控件— 一個(gè)TextBox，兩個(gè)DropDownLists和一個(gè)CheckBox —并且包含驗(yàn)證控件。當(dāng)創(chuàng)建編輯界面時(shí)，不管使用什么控件，步驟都是一樣的：先為EditItemTemplate添加控件；將字段值通過綁定語法賦給對(duì)應(yīng)的web控件的屬性；在UpdateCommand事件處理中編程訪問web控件和它們的屬性，并將值傳給BLL。

　　當(dāng)創(chuàng)建編輯界面時(shí)，無論它僅僅是由TextBox組成還是由不同的web控件組成，要確保正確的處理數(shù)據(jù)庫NULL值。當(dāng)處理NULL時(shí)，不僅需要在編輯界面正確顯示已經(jīng)存在的NULL值，還需要提供輸入NULL值的方法。對(duì)DataLists里的DropDownLists 來說，這通常意味著需要添加一個(gè)Value屬性被顯式設(shè)為空字符串(Value="")的ListItem，然后在UpdateCommand事件處理里判斷NULL ListItem是否被選中。

　　祝編程快樂！

作者簡(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有所幫助。