導言

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

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

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

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

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

第一步: 顯示Product 信息

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

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

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

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>

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

圖 3: 顯示product信息

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

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

　　點擊DataList的智能標簽上的“Edit Templates”，選擇EditItemTemplate,為它添加一個ID為Categories的EditItemTemplate。

圖 4: 為Categories添加一個DropDownList

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

圖 5: 創(chuàng)建 ObjectDataSource

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

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

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

　　最后添加Update 和Cancel button。記得這兩個button的CommandName屬性必須分別設為“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復制過來的代碼）。在添加綁定語法前我們首先為DataList的EditCommand和CancelCommand創(chuàng)建事件處理。EditCommand事件處理的目標是為了將Edit button被點擊的item展示為編輯狀態(tài)，而CancelCommand的目標是將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();
}

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

圖 8: 點擊Edit Button顯示編輯界面

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

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

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

圖 9: 點擊Edit Button 顯示編輯界面

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

　　當用戶編輯product并點Update button后，會postback并激發(fā)UpdateCommand事件。在事件處理里，我們需要從EditItemTemplate里讀出web控件的值，并和BLL交互，然后更新數(shù)據(jù)庫里的product。如我們在前面一章看到的那樣，被更新的product的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屬性來確保所有的驗證控件都返回合法值。如果Page.IsValid為True，從DataKeys集合里讀出被編輯的product 的ProductID的值，并引用EditItemTemplate里的web控件。然后將這些控件的值讀到變量里，并傳給UpdateProduct方法。完成更新后，DataList會返回到編輯前的狀態(tài)。

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

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

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

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

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ù)庫空值的item時，要確保是通過聲明語法來完成的。如果你使用設計器的ListItem集合編輯器，當賦空字符串時，產(chǎn)生的聲明語法會忽略Value的設置，產(chǎn)生想asp:ListItem>(None)/asp:ListItem>這樣的語句。這個看起來并沒有什么關系，但是缺少Value會讓DropDownList 使用Text屬性的值作為Value。這意味著當NULL  ListItem被選擇時，“(None)” 會被賦給product的CategoryID或SupplierID字段，這會引起異常。而顯式的將Value設為“”，當NULL  ListItem被選擇時一個空值會被賦給product的CategoryID或SupplierID字段?，F(xiàn)在瀏覽該頁。當編輯product時，注意Categories和Suppliers DropDownLists 開頭都包含一個“(None)”選項。

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

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

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);

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

總結(jié)

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

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

　　祝編程快樂！

作者簡介

　　本系列教程作者 Scott Mitchell，著有六本ASP/ASP.NET方面的書，是4GuysFromRolla.com的創(chuàng)始人，自1998年以來一直應用 微軟Web技術(shù)。大家可以點擊查看全部教程《[翻譯]Scott Mitchell 的ASP.NET 2.0數(shù)據(jù)教程》，希望對大家的學習ASP.NET有所幫助。