導言
在前面我們學習了如何創建item級的DataList。和可編輯的GridView一樣，每個DataList裡的item都包含一個Edit button，當點擊時，item會變的可編輯。item級的編輯在偶爾需要更新時沒什麼問題，但是在有些情況下用戶需要編輯大量的記錄。如果一個用戶需要編輯許多記錄，他會被迫去不停的去點擊Edit，作出修改，然後點擊Update，這些大量的點擊會妨礙他的工作效率。在這樣的情況下，一個好的選擇是提供一個完全可編輯的DataList，它的所有的item都處於編輯模式下，它的所有的值都可以通過點擊一個“Update All”button來更新。見圖1。
圖 1: 一個完全可編輯的DataList 的所有item都可以被修改
本章我們來學習如何創建一個完全可編輯的DataList，它提供用戶更新supplier的address的功能。
第一步: 在DataList的 ItemTemplate創建一個可編輯的用戶界面
在前面創建一個標准的item級編輯的DataList時，我們使用了兩個template：
ItemTemplate — 包含只讀的用戶界面(使用 Label 顯示每個product的 name 和price).
EditItemTemplate — 包含編輯的用戶界面(兩個TextBox ).
DataList的EditItemIndex屬性表明了哪個DataListItem使用EditItemTemplate來展示（如果有的話）。即ItemIndex的值等於DataList的EditItemIndex的DataListItem使用EditItemTemplate來展示。在一次只編輯一個item的情況下，這個模式工作的很好，但是在創建完全可編輯的DataList的時候就不適用了。
對完全可編輯的DataList來說，我們需要所有的DataListItem都以可編輯的界面來展示。最簡單的方法是在ItemTemplate裡定義可編輯的界面。對修改supplier的address信息而言，可編輯界面裡supplier表現為文本，address，city和country的值都用TextBox來表示。
首先打開BatchUpdate.aspx頁，添加一個DataList，將ID設為Suppliers。通過智能標簽添加一個名為SuppliersDataSource的ObjectDataSource控件。
圖2: 創建一個名為SuppliersDataSource的ObjectDataSource
使用SuppliersBLL類的GetSuppliers()方法配置ObjectDataSource（見圖3）。象前面一章那樣，我們將直接使用 BLL而不是通過ObjectDataSource來更新supplier信息。在UPDATE標簽裡選擇None（見圖4）。
圖 3: 使用GetSuppliers() 方法配置ObjectDataSource
圖 4: 設置UPDATE 標簽為None
完成向導後，Visual Studio會自動生成DataList的ItemTemplate來在Label裡顯示每個數據字段。我們需要修改這個template讓它提供編輯界面。ItemTemplate可以在設計器裡通過DataList的智能標簽上的Edit Templates或直接寫聲明語法來自定義。
創建一個編輯界面，將supplier的name表現為文本，address，city和country表現為TextBox。完成這些後，你的聲明代碼應該和下面差不多：
<asp:DataList ID="Suppliers" runat="server" DataKeyField="SupplierID"
DataSourceID="SuppliersDataSource">
<ItemTemplate>
<h4><asp:Label ID="CompanyNameLabel" runat="server"
Text='<%# Eval("CompanyName") %>' /></h4>
<table border="0">
<tr>
<td class="SupplierPropertyLabel">Address:</td>
<td class="SupplierPropertyValue">
<asp:TextBox ID="Address" runat="server"
Text='<%# Eval("Address") %>' />
</td>
</tr>
<tr>
<td class="SupplierPropertyLabel">City:</td>
<td class="SupplierPropertyValue">
<asp:TextBox ID="City" runat="server"
Text='<%# Eval("City") %>' />
</td>
</tr>
<tr>
<td class="SupplierPropertyLabel">Country:</td>
<td class="SupplierPropertyValue">
<asp:TextBox ID="Country" runat="server"
Text='<%# Eval("Country") %>' />
</td>
</tr>
</table>
<br />
</ItemTemplate>
</asp:DataList>
<asp:ObjectDataSource ID="SuppliersDataSource" runat="server"
OldValuesParameterFormatString="original_{0}"
SelectMethod="GetSuppliers" TypeName="SuppliersBLL">
</asp:ObjectDataSource>
注意：和前面一章一樣，需要為DataList開啟view state。
在ItemTemplate裡我使用了兩個新的CSS類，SupplierPropertyLabel和SupplierPropertyValue。它們的風格設置和ProductsPropertyLabel和ProductPropertyValue CSS類一樣，並已經加入到Styles.css中。
.ProductPropertyLabel, .SupplierPropertyLabel
{
font-weight: bold;
text-align: right;
}
.ProductPropertyValue, .SupplierPropertyValue
{
padding-right: 35px;
}
完成這些後浏覽頁面。如圖5所示，每個DataList的item用文本顯示supplier name，用TextBox顯示address，city和country。
圖 5: DataList裡的每個Supplier都可編輯
第二步: 增加“Update All” Button
圖5裡顯示的信息暫時還沒提供Update按鈕。完全可編輯的DataList應該只包含一個"Update All"按鈕，而不是象前面那樣，每個item包含一個button。當點擊"Update All"時，DataList裡的所有記錄將被更新。本章我們將添加兩個"Update All"button- 一個在頁的上面，一個在下面（兩個都提供相同的功能）。
先在DataList上面添加一個ID為UpdateAll1的Button。然後在DataList下面添加ID為UpdataAll2的Button。兩個Button的Text都設為"Update All"。最後為兩個Button的Click事件都創建一個event handler。我們創建一個方法，“UpdateAllSupplierAddress”,然後在事件處理中調用它。（而不是在兩個事件處理裡復制相同的代碼）
protected void UpdateAll1_Click(object sender, EventArgs e)
{
UpdateAllSupplierAddresses();
}
protected void UpdateAll2_Click(object sender, EventArgs e)
{
UpdateAllSupplierAddresses();
}
private void UpdateAllSupplierAddresses()
{
// TODO: Write code to update _all_ of the supplier addresses in the DataList
}
圖6是添加完"Update All"button後的頁面。
圖 6: 頁面添加了兩個“Update All” Button
第三步: 更新所有的Suppliers的 Address 信息
完成了將所有的item顯示為可編輯的界面和添加了“Update All”button後，剩下的事就是寫代碼執行批量更新。我們需要便利DataList的item，調用SuppliersBLL類的UpdateSupplierAddress方法。
可以通過DataList的Items property 來訪問DataListItem集合。通過DataListItem的引用，我們可以從DataKeys集合裡獲取相關的SuppliserID，並引用ItemTemplate裡的TextBox，見下面的代碼：
private void UpdateAllSupplierAddresses()
{
// Create an instance of the SuppliersBLL class
SuppliersBLL suppliersAPI = new SuppliersBLL();
// Iterate through the DataList's items
foreach (DataListItem item in Suppliers.Items)
{
// Get the supplierID from the DataKeys collection
int supplierID = Convert.ToInt32(Suppliers.DataKeys[item.ItemIndex]);
// Read in the user-entered values
TextBox address = (TextBox)item.FindControl("Address");
TextBox city = (TextBox)item.FindControl("City");
TextBox country = (TextBox)item.FindControl("Country");
string addressValue = null, cityValue = null, countryValue = null;
if (address.Text.Trim().Length > 0)
addressValue = address.Text.Trim();
if (city.Text.Trim().Length > 0)
cityValue = city.Text.Trim();
if (country.Text.Trim().Length > 0)
countryValue = country.Text.Trim();
// Call the SuppliersBLL class's UpdateSupplierAddress method
suppliersAPI.UpdateSupplierAddress
(supplierID, addressValue, cityValue, countryValue);
}
}
當用戶點擊一個"Update All"button時，每個Supplier DataList裡的DataListItem都執行UpdateAllSupplierAddress方法，並調用SuppliersBLL類的UpdateSupplierAddress方法，將相關的值傳過去。如果address，city或country裡不輸入值，UpdateSupplierAddress會接收一個空值（不是空字符串），而相關的字段的結果會是一個database NULL。
注意：你可以添加一個顯示的狀態Label，當批量更新完成後通過它來提供一些確認信息。只更新 Addresses被修改過的記錄
本章使用的批量更新法則為每個DataList裡的supplier調用UpdateSupplierAddress方法，無論address信息是否被修改過。雖然這種盲目的更新一般情況下不會有什麼性能問題，但是如果你有做數據庫表的審計，那樣將會導致很多多余的記錄。每次用戶點擊"Update All"button後，不管用戶是否有修改，系統裡都會為每個supplier產生一個一條新的審計記錄。
ADO.NET的DateTable和DataAdapter類被設計用來支持批量更新那些僅僅被修改，刪除或新增的記錄。DataTable的每個row都有RowState property 來指明這個row是否是新增到DataTable或從它裡面刪除，修改，或沒有改變。當DataTable剛產生時，所有的row都被標記為未修改的，修改了row的任何列後row會被標記為已修改的。
在SuppliersBLL類裡我們首先將supplier的記錄讀進SuppliersDataTable裡然後設置Address,City和Country列的值來更新指定的supplier的信息，見以下代碼：
public bool UpdateSupplierAddress
(int supplierID, string address, string city, string country)
{
Northwind.SuppliersDataTable suppliers =
Adapter.GetSupplierBySupplierID(supplierID);
if (suppliers.Count == 0)
// no matching record found, return false
return false;
else
{
Northwind.SuppliersRow supplier = suppliers[0];
if (address == null)
supplier.SetAddressNull();
else
supplier.Address = address;
if (city == null)
supplier.SetCityNull();
else
supplier.City = city;
if (country == null)
supplier.SetCountryNull();
else
supplier.Country = country;
// Update the supplier Address-related information
int rowsAffected = Adapter.Update(supplier);
// Return true if precisely one row was updated,
// otherwise false
return rowsAffected == 1;
}
}
無論值是否有被修改，這段代碼都將傳入的address，city和country的值賦給SuppliersDataTable的SuppliersRow。這個修改將使SuppliersRow的RowState屬性被標記為已修改的。當DAL的Update方法被調用時，它發現SupplierRow已經被修改了，因此向數據庫發送UPDATE命令。
然而想象一下，我們為這個方法添加的代碼僅僅在和已經存在的值不一樣時才將傳入的address，city和country的值賦給SuppliersRow。在address，city和country沒有修改的情況下，SupplierRow的RowState仍然標記為未改變。這樣的結果是當DAL的Update方法被調用時，SuppliersRow沒有被修改，因此不會調用數據庫。使用以下的代碼代替前面盲目的賦值：
// Only assign the values to the SupplierRow's column values if they differ if (address == null && !supplier.IsAddressNull()) supplier.SetAddressNull(); else if ((address != null && supplier.IsAddressNull()) || (!supplier.IsAddressNull() && string.Compare(supplier.Address, address) != 0)) supplier.Address = address; if (city == null && !supplier.IsCityNull()) supplier.SetCityNull(); else if ((city != null && supplier.IsCityNull()) || (!supplier.IsCityNull() && string.Compare(supplier.City, city) != 0)) supplier.City = city; if (country == null && !supplier.IsCountryNull()) supplier.SetCountryNull(); else if ((country != null && supplier.IsCountryNull()) || (!supplier.IsCountryNull() && string.Compare(supplier.Country, country) != 0)) supplier.Country = country;
增加了這些代碼後，DAL的Update方法僅僅在更改過address相關的值的那些記錄裡才向數據庫發送UPDATE命令。
當然我們也可以追蹤傳入的字段和數據庫數據是否有區別，如果沒有，就不需要調用DAL的Update方法。這種方法在你使用直接的數據庫命令時非常有效，因為直接的數據庫命令不會檢查SuppliersRow來決定是否需要調用數據庫。
注意：每次UpdateSupplierAddress方法被調用時，都會調用一次數據庫來獲取需要更新的記錄的信息。如果數據被修改，又要調用一次數據庫來更新數據。這個流程可以通過創建一個重載的UpdateSupplierAddress方法來優化，這個方法接受一個EmployeesDataTable ，它包含BatchUpdate.aspx頁的所有的修改。然後它會調用一次數據庫來獲取Suppliers表裡的所有記錄。在結果集裡僅僅是被修改過的記錄才能被更新。
總結
本章學習了如何創建一個完全可編輯的DataList。通過它用戶可以快速的修改多個supplier的address信息。我們首先定義了編輯界面 — address，city和country都以TextBox來表示 — 在DataList的ItemTemplate裡。然後我們在DataList的上下各添加了一個“Update All”button。用戶修改完後，點擊其中一個後，每個DataListItem都會調用SuppliersBLL類的UpdateSupplierAddress方法。
祝編程愉快!
作者簡介
本系列教程作者 Scott Mitchell，著有六本ASP/ASP.NET方面的書，是4GuysFromRolla.com的創始人，自1998年以來一直應用 微軟Web技術。大家可以點擊查看全部教程《[翻譯]Scott Mitchell 的ASP.NET 2.0數據教程》，希望對大家的學習ASP.NET有所幫助。
