建立完全可編輯的DataGrid

在論壇中我看到許多相同或相似的問題：我怎麼能在我的DataGrid的每一行中放置檢查框、文字方塊等等？怎樣更新它們的值？答案相當簡單，在這篇文章中，我將向你們展示如何完成它。

我們都知道，DataGrid是一個功能非常強大的工具。根據我的經驗，在90%以上的時間中， DataGrid 都被用來顯示數據，並可能一次編輯一行數據。 而某些時候，可能需要一次編輯多行，甚至是所有資料。一個實際的例子就是在網路上銷售物品的應用程式中， 顧客可能一次要變更他們籃子中的一種或多種物品，點擊檢查框移去他們不想要的商品。

構想

在這個範例中，我寫了一個簡單的WebForm來管理儲存在XML中的聯絡人清單。 這個需求是非常簡單的：具有新增聯絡人，編輯/刪除現有聯絡人的能力。使用者可以一次修改或刪除多個聯絡人，我也允許使用者按他們選定的列來對資料網格進行排序。

我的例子是用C# 寫的。 如果你比較喜歡這些程式碼的VB版本，在下載檔案中有這兩種格式的程式碼。

Contacts.xml

這個範例中的XML 資料檔非常簡單直覺。由於它非常簡單，所以我沒有創建規劃。

<?xml version="1.0" standalone="yes"?>
<Contacts>
<Contact>
<Email>[email protected]</Email>
<FirstName>John</FirstName>
<LastName>Doe</LastName>
</Contact>
<Contact>
<Email>[email protected]</Email>
<FirstName>Jane</FirstName>
<LastName>Doe</LastName>
</Contact>
</Contacts>

ContactList.aspx

設定WebForm 非常簡單。我放置了一個新的DataGrid 到我的窗體中，並且設定它為4列，第一列都包含了用來刪除聯絡人的檢查框。你會注意到我在這裡做的主要工作就是以模板列( TemplateColumn)的形式建立了每一列。 這允許我放置文字方塊和檢查框物件到資料模板(ItemTemplate)中. 這是一個在網格每一行中顯示文字以外的其它東西的技巧。 除此之外，你還會注意到我使用FooterTemplate 來讓新聯絡人變得簡單而直觀。

我也包含了一個連結按鈕(LinkBut​​ton)，用來儲存使用者所做的修改及刪除操作。但它並不用來添加新聯絡人。新增聯絡人的操作由最後一列的頁尾範本中連結按鈕(LinkBut​​ton)來完成。

<asp:datagrid id="dgContacts" runat="server" ShowFooter="True" AllowSorting="True" Forefont color="Black" GridLines="None" CellPadding="2" Backfont color="LightGoldenrodYellow" BorderWidth="1pxx " Borderfont color="Tan" Width="499px" AutoGenerateColumns="False" DataKeyField="Email">
<SelectedItemStyle Forefont color="GhostWhite" Backfont color="DarkSlateBlue"></SelectedItemStyle>
<AlternatingItemStyle Backfont color="PaleGoldenrod"></AlternatingItemStyle>
<HeaderStyle Font-Bold="True" Backfont color="Tan"></HeaderStyle>
<FooterStyle Backfont color="Tan"></FooterStyle>
<Columns>
<asp:TemplateColumn SortExpression="FirstName" HeaderText="First Name">
<ItemTemplate>
<asp:TextBox id=First runat="server" Width="109px" Text='<%# DataBinder.Eval(Container, "DataItem.FirstName") %>'>
</asp:TextBox>
</ItemTemplate>
<FooterTemplate>
<asp:TextBox id="NewFirst" runat="server" Width="109px"></asp:TextBox>
</FooterTemplate>
</asp:TemplateColumn>
<asp:TemplateColumn SortExpression="LastName" HeaderText="Last Name">
<ItemTemplate>
<asp:TextBox id=Last runat="server" Width="109px" Text='<%# DataBinder.Eval(Container, "DataItem.LastName") %>'>
</asp:TextBox>
</ItemTemplate>
<FooterTemplate>
<asp:TextBox id="NewLast" runat="server" Width="109px"></asp:TextBox>
</FooterTemplate>
</asp:TemplateColumn>
<asp:TemplateColumn SortExpression="Email" HeaderText="Email">
<ItemTemplate>
<asp:TextBox id=Email runat="server" Text='<%# DataBinder.Eval(Container, "DataItem.Email") %>'>
</asp:TextBox>
</ItemTemplate>
<FooterTemplate>
<asp:TextBox id="NewEmail" runat="server"></asp:TextBox>
</FooterTemplate>
</asp:TemplateColumn>
<asp:TemplateColumn HeaderText="Delete Contact">
<ItemStyle Horizo​​ntalAlign="Center"></ItemStyle>
<ItemTemplate>
<asp:CheckBox Runat="server" ID="chkDelete"></asp:CheckBox>
</ItemTemplate>
<FooterStyle Horizo​​ntalAlign="Center"></FooterStyle>
<FooterTemplate>
<asp:LinkBut​​ton Runat="server" Text="Add" CommandName="Add" ID="Linkbutton1" NAME="Linkbutton1"></asp:LinkBut​​ton>
</FooterTemplate>
</asp:TemplateColumn>
</Columns>
</asp:datagrid>

ContactList.cs

當我選擇用XML檔案來存取資料後，我就決定要使用DataSet來存取它。因為DataSet 物件有ReadXml 和WriteXml 方法，所以這是非常合理的選擇。第一步是在XML中讀取資料。正如你從程式碼中所看到的， 我創建了一個成員用來處理資料排序。

private DataSet _dsContacts;
private string _sSort;

private void Page_Load(object sender, System.EventArgs e)
{
// 載入XML 檔案.
_dsContacts = new DataSet();
_dsContacts.ReadXml(Server.MapPath("Contacts.xml"));
DataColumn[] dcPk = {_dsContacts.Tables["Contact"].Columns["Email"]};
_dsContacts.Tables["Contact"].PrimaryKey = dcPk;

if (!Page.IsPostBack )
{
// 如果是第一次裝載的話，綁定資料。
BindContacts();
_sSort = "FirstName";
}
else
{
// 否則，從檢視狀態讀取排序狀態.
_sSort = (string)ViewState["Sort"];
}
}

第二步，我創建了一個用來綁定資料到網格的方法，它包含了資料排序邏輯以及從磁碟讀取資料的方法。

private void BindContacts()
{
// 儲存排序狀態到視圖狀態中.
ViewState["Sort"] = _sSort;

// 綁定網格到已排序的資料視圖中.
DataView dv = new DataView(_dsContacts.Tables["Contact"]);
dv.Sort = _sSort;
dgContacts.DataSource = dv;
dgContacts.DataBind();
}

private void SaveContacts()
{
_dsContacts.WriteXml(Server.MapPath("Contacts.xml"));
}

ItemCommand 事件用來處理向清單中新增聯絡人。注意：我檢查了 CommandName 參數是否為Add. 它是來處理ASPX頁中網格最後一列的頁腳模板（FooterTemplate）中的連結按鈕（LinkBut​​ton）的回傳值。

private void dgContacts_ItemCommand(object source , System.Web.UI.WebControls.DataGridCommandEventArgs e)
{
// 新增資料到dataset. 這裡我使用了數組以提高處理效率.
if (e.CommandName == "Add")
{
string[] sContact = {"", "", ""};
sContact[0] = ((TextBox)e.Item.FindControl("NewEmail")).Text;
sContact[1] = ((TextBox)e.Item.FindControl("NewFirst")).Text;
sContact[2] = ((TextBox)e.Item.FindControl("NewLast")).Text;

_dsContacts.Tables["Contact"].Rows.Add(sContact);

SaveContacts();
}

BindContacts();
}

我跳過了SortCommand 程式碼，因為有許多其它文件已經非常詳細地討論過如何排序了。 如果你下載了這個例子的原始碼，它就包含在裡面。

最後，我將窗體上連結按鈕(LinkBut​​ton)的點擊事件(onClick)移到了這裡。 這裡我透過循環檢測DataGrid中的資料項來執行任何必要的刪除及更新操作。

private void btnUpdate_Click(object sender, System.EventArgs e)
{
// 循環處理每個資料項.
foreach (DataGridItem di in dgContacts.Items)
{
// 確信是資料項而不是頁首或頁尾.
if (di.ItemType == ListItemType.Item || di.ItemType == ListItemType.AlternatingItem)
{
// 取得更新或刪除操作執行以後的目前行.
DataRow dr = _dsContacts.Tables["Contact"].Rows.Find(dgContacts.DataKeys[di.ItemIndex]);

// 檢查是否需要刪除某行.
if (((CheckBox)di.FindControl("chkDelete")).Checked)
{
_dsContacts.Tables["Contact"].Rows.Remove(dr);//刪除指定行
}
else
{
//更新資料行.
dr["Email"] = ((TextBox)di.FindControl("Email")).Text;
dr["FirstName"] = ((TextBox)di.FindControl("First")).Text;
dr["LastName"] = ((TextBox)di.FindControl("Last")).Text;
}
}
}

// 如果有變化則保存它.
if (_dsContacts.HasChanges())
{
SaveContacts();
}

BindContacts();//綁定
}

結束語

我可以很容易地透過控制項的位置找到控制項中每一個DataGridItem的單元（Cells）。 有幾種方法可以實現它， 我確信你可以找到完成這項任務的更好的方法。正如你所看到的， 一次編輯整個資料網格是非常簡單的。 同樣的方法經過輕微的修改也可用於分頁網格