在ASP.NET 2.0中操作數(shù)據(jù)之三十七：DataList批量更新

導言

　　在前面我們學習了如何創(chuàng)建item級的DataList。和可編輯的GridView一樣，每個DataList里的item都包含一個Edit button，當點擊時，item會變的可編輯。item級的編輯在偶爾需要更新時沒什么問題，但是在有些情況下用戶需要編輯大量的記錄。如果一個用戶需要編輯許多記錄，他會被迫去不停的去點擊Edit，作出修改，然后點擊Update，這些大量的點擊會妨礙他的工作效率。在這樣的情況下，一個好的選擇是提供一個完全可編輯的DataList，它的所有的item都處于編輯模式下，它的所有的值都可以通過點擊一個“Update All”button來更新。見圖1。

圖 1: 一個完全可編輯的DataList 的所有item都可以被修改

　　本章我們來學習如何創(chuàng)建一個完全可編輯的DataList，它提供用戶更新supplier的address的功能。

第一步: 在DataList的 ItemTemplate創(chuàng)建一個可編輯的用戶界面

在前面創(chuàng)建一個標準的item級編輯的DataList時，我們使用了兩個template：

ItemTemplate — 包含只讀的用戶界面(使用 Label 顯示每個product的 name 和price).
EditItemTemplate — 包含編輯的用戶界面(兩個TextBox ).

　　DataList的EditItemIndex屬性表明了哪個DataListItem使用EditItemTemplate來展示（如果有的話）。即ItemIndex的值等于DataList的EditItemIndex的DataListItem使用EditItemTemplate來展示。在一次只編輯一個item的情況下，這個模式工作的很好，但是在創(chuàng)建完全可編輯的DataList的時候就不適用了。

　　對完全可編輯的DataList來說，我們需要所有的DataListItem都以可編輯的界面來展示。最簡單的方法是在ItemTemplate里定義可編輯的界面。對修改supplier的address信息而言，可編輯界面里supplier表現(xiàn)為文本，address，city和country的值都用TextBox來表示。

　　首先打開BatchUpdate.aspx頁，添加一個DataList，將ID設(shè)為Suppliers。通過智能標簽添加一個名為SuppliersDataSource的ObjectDataSource控件。

圖2: 創(chuàng)建一個名為SuppliersDataSource的ObjectDataSource

使用SuppliersBLL類的GetSuppliers()方法配置ObjectDataSource（見圖3）。象前面一章那樣，我們將直接使用 BLL而不是通過ObjectDataSource來更新supplier信息。在UPDATE標簽里選擇None（見圖4）。

圖 3: 使用GetSuppliers() 方法配置ObjectDataSource

圖 4: 設(shè)置UPDATE 標簽為None

　　完成向?qū)Ш?，Visual Studio會自動生成DataList的ItemTemplate來在Label里顯示每個數(shù)據(jù)字段。我們需要修改這個template讓它提供編輯界面。ItemTemplate可以在設(shè)計器里通過DataList的智能標簽上的Edit Templates或直接寫聲明語法來自定義。

　　創(chuàng)建一個編輯界面，將supplier的name表現(xiàn)為文本，address，city和country表現(xiàn)為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。它們的風格設(shè)置和ProductsPropertyLabel和ProductPropertyValue CSS類一樣，并已經(jīng)加入到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都設(shè)為"Update All"。最后為兩個Button的Click事件都創(chuàng)建一個event handler。我們創(chuàng)建一個方法，“UpdateAllSupplierAddress”,然后在事件處理中調(diào)用它。（而不是在兩個事件處理里復制相同的代碼）

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后，剩下的事就是寫代碼執(zhí)行批量更新。我們需要便利DataList的item，調(diào)用SuppliersBLL類的UpdateSupplierAddress方法。

　　可以通過DataList的Items property 來訪問DataListItem集合。通過DataListItem的引用，我們可以從DataKeys集合里獲取相關(guān)的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都執(zhí)行UpdateAllSupplierAddress方法，并調(diào)用SuppliersBLL類的UpdateSupplierAddress方法，將相關(guān)的值傳過去。如果address，city或country里不輸入值，UpdateSupplierAddress會接收一個空值（不是空字符串），而相關(guān)的字段的結(jié)果會是一個database NULL。

　　注意：你可以添加一個顯示的狀態(tài)Label，當批量更新完成后通過它來提供一些確認信息。只更新 Addresses被修改過的記錄

　　本章使用的批量更新法則為每個DataList里的supplier調(diào)用UpdateSupplierAddress方法，無論address信息是否被修改過。雖然這種盲目的更新一般情況下不會有什么性能問題，但是如果你有做數(shù)據(jù)庫表的審計，那樣將會導致很多多余的記錄。每次用戶點擊"Update All"button后，不管用戶是否有修改，系統(tǒng)里都會為每個supplier產(chǎn)生一個一條新的審計記錄。

　　ADO.NET的DateTable和DataAdapter類被設(shè)計用來支持批量更新那些僅僅被修改，刪除或新增的記錄。DataTable的每個row都有RowState property 來指明這個row是否是新增到DataTable或從它里面刪除，修改，或沒有改變。當DataTable剛產(chǎn)生時，所有的row都被標記為未修改的，修改了row的任何列后row會被標記為已修改的。

　　在SuppliersBLL類里我們首先將supplier的記錄讀進SuppliersDataTable里然后設(shè)置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方法被調(diào)用時，它發(fā)現(xiàn)SupplierRow已經(jīng)被修改了，因此向數(shù)據(jù)庫發(fā)送UPDATE命令。

　　然而想象一下，我們?yōu)檫@個方法添加的代碼僅僅在和已經(jīng)存在的值不一樣時才將傳入的address，city和country的值賦給SuppliersRow。在address，city和country沒有修改的情況下，SupplierRow的RowState仍然標記為未改變。這樣的結(jié)果是當DAL的Update方法被調(diào)用時，SuppliersRow沒有被修改，因此不會調(diào)用數(shù)據(jù)庫。使用以下的代碼代替前面盲目的賦值：

// 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相關(guān)的值的那些記錄里才向數(shù)據(jù)庫發(fā)送UPDATE命令。

　　當然我們也可以追蹤傳入的字段和數(shù)據(jù)庫數(shù)據(jù)是否有區(qū)別，如果沒有，就不需要調(diào)用DAL的Update方法。這種方法在你使用直接的數(shù)據(jù)庫命令時非常有效，因為直接的數(shù)據(jù)庫命令不會檢查SuppliersRow來決定是否需要調(diào)用數(shù)據(jù)庫。

　　注意：每次UpdateSupplierAddress方法被調(diào)用時，都會調(diào)用一次數(shù)據(jù)庫來獲取需要更新的記錄的信息。如果數(shù)據(jù)被修改，又要調(diào)用一次數(shù)據(jù)庫來更新數(shù)據(jù)。這個流程可以通過創(chuàng)建一個重載的UpdateSupplierAddress方法來優(yōu)化，這個方法接受一個EmployeesDataTable ，它包含BatchUpdate.aspx頁的所有的修改。然后它會調(diào)用一次數(shù)據(jù)庫來獲取Suppliers表里的所有記錄。在結(jié)果集里僅僅是被修改過的記錄才能被更新。

總結(jié)

　　本章學習了如何創(chuàng)建一個完全可編輯的DataList。通過它用戶可以快速的修改多個supplier的address信息。我們首先定義了編輯界面 — address，city和country都以TextBox來表示 — 在DataList的ItemTemplate里。然后我們在DataList的上下各添加了一個“Update All”button。用戶修改完后，點擊其中一個后，每個DataListItem都會調(diào)用SuppliersBLL類的UpdateSupplierAddress方法。

　　祝編程愉快!

作者簡介

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