用 AJAX 組件時常被問到一個問題:怎麼讓它和伺服器控件互動?例如要輸出一個列表,難道只能用 JavaScript 一行一行拼 HTML 嗎?
當然不必。這裡示範如何直接與 DataGrid 互動——關鍵技巧是讓伺服器控件先產生 HTML,再把那段 HTML 送回客戶端。
本文使用 AJAX.NET 的 .NET 1.1 版本,可從 https://ajax.schwarz-interactive.de/ 取得。
在專案中加入對 Ajax.dll 的參考。
放在 system.web 節點之內:
<httpHandlers> <add verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" /> </httpHandlers>
protected void Application_Start(Object sender, EventArgs e)
{
Ajax.Utility.HandlerPath = "ajax";
}
這個類別提供兩個方法:一個更新資料庫,一個輸出列表。核心思路就是取得控件渲染後的 HTML 再回傳。
[Ajax.AjaxMethod]
public int AddAjaxTable(string name)
{
// 輸入一個字串,寫入資料庫
SqlConnection conn = new SqlConnection(
System.Configuration.ConfigurationSettings.AppSettings["connectionString"]);
SqlCommand cmd = new SqlCommand(
"insert into AjaxTable(name) values(@name)", conn);
cmd.Parameters.AddWithValue("@name", name);
cmd.Connection.Open();
int result = cmd.ExecuteNonQuery();
conn.Dispose();
cmd.Dispose();
return result;
}
[Ajax.AjaxMethod]
public string GetAjaxTable()
{
// 這個方法的重點:拿到 DataGrid 渲染出來的 HTML
SqlConnection conn = new SqlConnection(
System.Configuration.ConfigurationSettings.AppSettings["connectionString"]);
SqlCommand cmd = new SqlCommand("select * from AjaxTable order by id", conn);
SqlDataAdapter ap = new SqlDataAdapter(cmd);
DataSet ds = new DataSet();
ap.SelectCommand.Connection.Open();
ap.Fill(ds, "db");
conn.Dispose();
cmd.Dispose();
// 建立 DataGrid 並設定資料來源
DataGrid dg = new DataGrid();
dg.DataSource = ds.Tables["db"];
dg.DataBind();
// 用 HtmlTextWriter 攔截渲染結果
System.Text.StringBuilder strb = new System.Text.StringBuilder();
System.IO.StringWriter sw = new System.IO.StringWriter(strb);
System.Web.UI.HtmlTextWriter htw = new HtmlTextWriter(sw);
dg.RenderControl(htw); // 執行控件的渲染
return strb.ToString(); // 回傳 HTML
}
這段程式最值得學的是最後幾行:建立一個 StringBuilder,用 StringWriter 包起來,再用 HtmlTextWriter 包住它,然後呼叫 dg.RenderControl(htw)。DataGrid 於是把整張表格的 HTML 寫進了我們的字串緩衝區,而不是寫進頁面。這是一個通用的 .NET 技巧,任何伺服器控件都能這樣「取出 HTML」。
function AddAjax(name)
{
DemoMethods.AddAjaxTable(name);
LoadGrid();
}
function LoadGrid()
{
var cc = document.getElementById("UCtd");
cc.innerHtml = DemoMethods.GetAjaxTable().value;
}
新增一筆資料後立刻重新抓一次列表,塞進指定的 td 元素中。使用者看到的是「新增後表格馬上多一列」,中間沒有任何頁面重載。
private void Page_Load(object sender, System.EventArgs e)
{
Ajax.Utility.RegisterTypeForAjax(typeof(AjaxTestPrjLib.DemoMethods));
}
注意這裡註冊的是 DemoMethods 類別,而不是頁面本身——因為方法都寫在這個獨立類別裡。這也呼應了 AJAX.NET 的設計:註冊什麼型別,客戶端就會產生對應的代理物件。
<%@ Page language="c#" Codebehind="default.aspx.cs"
AutoEventWireup="false" Inherits="AjaxTextPrjWeb._default" %>
<html>
<head>
<title>default</title>
<script language="Javascript" src="default.js"></script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<input type="text" id="AddTextBox" maxlength="10">
<input type="button" value="新增" onclick="AddAjax(AddTextBox.value)">
<table>
<tr><td id="UCtd"></td></tr>
</table>
</form>
</body>
</html>
流程其實很單純:伺服器端用控制項產生 HTML → 回傳字串 → 客戶端塞進容器。這比用 JavaScript 手動拼表格既短又不容易出錯,而且表格樣式完全由 DataGrid 的既有設定決定。
不過實務上有幾點要留意:
AddAjaxTable 已改用參數化查詢避免 SQL 注入,輸出端也應同樣謹慎。