Wijmo 更优美的jQuery UI部件集：客户端更改C1GridView数据源

很多时候，我们在使用 GridView 展示数据时，希望最终用户可以编辑数据并且同步到数据源中。这是一项繁琐的工作。我们需要自定义模板列，并且在后台手动获取更新值，最后使用 SQL 语句同步到数据库中。 

但是，现在我们有了 C1 Wijmo GridView ,这些繁琐的工作都成为历史。C1GridView 仅仅通过一个属性-AllowClientEditing 便允用户在客户端编辑单元格内容。

需要编辑时，我们可以通过双击单元格使其进入编辑状态即可。完成编辑后，选择其它单元格去保存编辑值。 

这篇文章将叙述在不执行任何 PostBack 的情况下，如何轻而易举的更新数据库。 

1.定义数据库连接字符串并且绑定到 C1GridView

C1GridView 可以绑定 Oledb 数据源或 SQL 数据源。本文中，我们将使用 Oledb 数据源。请根据下面的代码设置 DataKeyNames 和 C1GridView 相关列。同时，我们需要设定 CallbackSettings 值为 editing ，这样在我们保存时，不会发生 Postback。

参考代码:

<wijmo:C1GridView ID="C1GridView1" runat="server"



AutogenerateColumns="false" DataKeyNames="CustomerID" ClientSelectionMode="SingleRow"



AllowClientEditing="true" ShowFilter="true"



OnEndRowUpdated="C1GridView1_EndRowUpdated">



<CallbackSettings Action="Editing, Filtering" />



<Columns>



<wijmo:C1BoundField DataField="CustomerID" HeaderText="CustomerID" SortExpression="CustomerID">



</wijmo:C1BoundField>



<wijmo:C1BoundField DataField="CompanyName" HeaderText="Company Name" SortExpression="CompanyName">



</wijmo:C1BoundField>



<wijmo:C1BoundField DataField="ContactName" HeaderText="Contact Name" SortExpression="ContactName">



</wijmo:C1BoundField>



<wijmo:C1BoundField DataField="City" HeaderText="City" SortExpression="City">



</wijmo:C1BoundField>



<wijmo:C1BoundField DataField="Country" HeaderText="Country" SortExpression="Country">



</wijmo:C1BoundField>



</Columns>



</wijmo:C1GridView>

 

2.下面，我们定义 Oledb 数据库连接字符串。因为需要将更改同步到数据库中，所以我们需要写 SQL 语句去同步数据源。

参考代码：

public DataTable GetDataTable()



{



DataTable dt = Page.Session["Customers"] as DataTable;



OleDbConnection con = new OleDbConnection("provider=Microsoft.Jet.Oledb.4.0; Data Source=" + Server.MapPath("~/App_Data/C1NWind.mdb"));



OleDbDataAdapter da = new OleDbDataAdapter();



da.SelectCommand = new OleDbCommand("SELECT * FROM [Customers] Order By [CustomerID]", con);



da.UpdateCommand = new OleDbCommand("Update [Customers] set [CompanyName]=?, [ContactName]=?, [City]=?, [Country]=? where CustomerID = ?", con);



da.UpdateCommand.Parameters.Add("@CompanyName", OleDbType.VarChar, 50, "CompanyName");



da.UpdateCommand.Parameters.Add("@ContactName", OleDbType.VarChar, 50, "ContactName");



da.UpdateCommand.Parameters.Add("@City", OleDbType.VarChar, 50, "City");



da.UpdateCommand.Parameters.Add("@Country", OleDbType.VarChar, 50, "Country");



da.UpdateCommand.Parameters.Add("@CustomerID", OleDbType.VarChar, 50, "CustomerID");



if (dt == null)



{



dt = new DataTable();



da.Fill(dt);



dt.PrimaryKey = new DataColumn[] { dt.Columns["CustomerID"] };



Page.Session["Customers"] = dt;



}



da.Update(dt);



return dt;



}

 

3.我们仅需在 RowUpdating 和 EndRowUpdated 事件中更新被编辑的行。在客户端使用 C1 Wijmo GridView 修改数据源。

protected void C1GridView1_RowUpdating(object sender, C1.Web.Wijmo.Controls.C1GridView.C1GridViewUpdateEventArgs e)



{



DataTable customers = GetDataTable();



DataRow row = customers.Rows.Find(C1GridView1.DataKeys[e.RowIndex].Value);



if (row != null)



{



foreach (DictionaryEntry entry in e.NewValues)



{



row[(string)entry.Key] = entry.Value;



}



}



else



{



throw new RowNotInTableException();



}



Page.Session["Customers"] = customers;



}

 

 在 EndRowUpdated 事件中重新绑定 C1GridView 数据源。

protected void C1GridView1_EndRowUpdated(object sender, C1.Web.Wijmo.Controls.C1GridView.C1GridViewEndRowUpdatedEventArgs e)



{



C1GridView1.DataSource = GetDataTable();



C1GridView1.DataBind();



}

 

不过，有时 C1GridView 中仅仅有一行数据（例如：执行了过滤操作）。用户编辑这一行，但是我们并没有其他行可以点击，从而无法保存更改。不要着急！

我们只需要添加 button 去调用 C1GridView 的前台方法 Update即可。

<asp:Button ID="btn1" runat="server" Text="Update C1GridView"OnClientClick="btn_ClientClick(); return false;" />

 

使用下面代码调用 Update() 方法：

function btn_ClientClick(sender, args)



{



var grid = $("#C1GridView1");



grid.c1gridview("endEdit");



grid.c1gridview("update");



}

 

 

好了，现在我们可以运行程序查看效果了。

Demo 下载：Sample_C1GridView_ClientSideUpdate.zip

Wijmo下载，请进入Studio for ASP.NET Wijmo 2012 v1正式发布（2012.03.22更新）!