DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
AJAX 如何與 ASP.NET 的 Server 控件互動:讓 DataGrid 自己吐 HTML
編輯:AJAX詳解     

用 AJAX 組件時常被問到一個問題:怎麼讓它和伺服器控件互動?例如要輸出一個列表,難道只能用 JavaScript 一行一行拼 HTML 嗎?

當然不必。這裡示範如何直接與 DataGrid 互動——關鍵技巧是讓伺服器控件先產生 HTML,再把那段 HTML 送回客戶端。

前置作業

本文使用 AJAX.NET 的 .NET 1.1 版本,可從 https://ajax.schwarz-interactive.de/ 取得。

1. 加入參考

在專案中加入對 Ajax.dll 的參考。

2. 在 web.config 註冊 HttpHandler

放在 system.web 節點之內:

<httpHandlers>
  <add verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" />
</httpHandlers>

3. 在 Global.asax 設定處理路徑

protected void Application_Start(Object sender, EventArgs e)
{
    Ajax.Utility.HandlerPath = "ajax";
}

4. 建立方法類別 DemoMethods

這個類別提供兩個方法:一個更新資料庫,一個輸出列表。核心思路就是取得控件渲染後的 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」。

5. 建立 default.js

function AddAjax(name)
{
    DemoMethods.AddAjaxTable(name);
    LoadGrid();
}

function LoadGrid()
{
    var cc = document.getElementById("UCtd");
    cc.innerHtml = DemoMethods.GetAjaxTable().value;
}

新增一筆資料後立刻重新抓一次列表,塞進指定的 td 元素中。使用者看到的是「新增後表格馬上多一列」,中間沒有任何頁面重載。

6. 在 default.aspx 的 Page_Load 註冊

private void Page_Load(object sender, System.EventArgs e)
{
    Ajax.Utility.RegisterTypeForAjax(typeof(AjaxTestPrjLib.DemoMethods));
}

注意這裡註冊的是 DemoMethods 類別,而不是頁面本身——因為方法都寫在這個獨立類別裡。這也呼應了 AJAX.NET 的設計:註冊什麼型別,客戶端就會產生對應的代理物件。

7. 頁面的 HTML 與事件綁定

<%@ 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 的既有設定決定。

不過實務上有幾點要留意:

  • RenderControl 的時機。在頁面生命週期之外建立並渲染控制項,某些需要 ViewState 或完整週期的控制項可能不會完全正常。DataGrid 沒問題,但更複雜的控制項要實際測試。
  • 回傳的 HTML 必須可信。把伺服器控件產生的 HTML 直接塞進 innerHtml,等於信任那段內容。若其中含有使用者輸入而未經編碼,就會形成 XSS。範例中 AddAjaxTable 已改用參數化查詢避免 SQL 注入,輸出端也應同樣謹慎。
  • 每次呼叫都重抓一次資料庫。新增後立刻查一次,在小資料量下沒問題;資料量大時應考慮只回傳新增的那一列,或用前端 DOM 操作插入,省下一趟查詢。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved