導(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ì)要求為ListItem 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è)谇懊嬉徽驴吹降哪菢?,被更新的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屬性來確保所有的驗(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字段?,F(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有所幫助。
您可能感興趣的文章:- ASP.NET2.0數(shù)據(jù)庫入門之SqlDataSource
- SqlDataSource 鏈接Access 數(shù)據(jù)
- aspx中的mysql操作類sqldatasource使用示例分享
- 在ASP.NET 2.0中操作數(shù)據(jù)之三十九:在DataList的編輯界面里添加驗(yàn)證控件
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十一:DataList和Repeater數(shù)據(jù)分頁
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十二:DataList和Repeater數(shù)據(jù)排序(一)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十三:DataList和Repeater數(shù)據(jù)排序(二)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十四:DataList和Repeater數(shù)據(jù)排序(三)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十五:DataList和Repeater里的自定義Button
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十六:使用SqlDataSource控件檢索數(shù)據(jù)
- 在ASP.NET 2.0中操作數(shù)據(jù)之四十七:用SqlDataSource控件插入、更新、刪除數(shù)據(jù)