DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
在 ASP.NET 中實作 Ajax(二):回呼、型別與自訂轉換器
編輯:AJAX詳解     

當然,我們不會只把這種能力用來跳 alert。所有客戶端代理(例如 Sample.ServerSideAdd 函數)都接受額外參數,用來指定處理伺服器回應的回呼函數:

Sample.ServerSideAdd(100, 99, ServerSideAdd_CallBack);

function ServerSideAdd_CallBack(response) {
    if (response.error != null) {
        alert(response.error);
        return;
    }
    alert(response.value);
}

回呼函數會收到一個 response 物件,它公開幾個主要屬性:

  • value:伺服器端函數實際回傳的值(字串、自訂物件或資料集)。
  • error:若有錯誤,則為錯誤訊息。
  • request:XMLHttpRequest 的原始回應。
  • context:上下文物件。

先檢查 error 是否為 null,就知道這次呼叫有沒有出錯;只要在伺服器端函數中丟出例外,error 屬性就會被填好。request 屬性則可取得更多細節。

處理型別

回傳複雜型別

Ajax 包裝器不只處理 ServerSideAdd 回傳的整數,還支援 integers、strings、double、booleans、DateTime、DataSet、DataTable,以及自訂類別與陣列;其他型別一律回傳其 ToString() 結果。

回傳的 DataSet 與真正的 .NET DataSet 幾乎一樣,在客戶端可以直接走訪其中的表格與資料列來渲染。

Ajax 也能回傳自訂類別,唯一要求是必須標上 Serializable 屬性:

[Serializable()]
public class User {
    private int _userId;
    private string _firstName;
    private string _lastName;

    public int userId {
        get { return _userId; }
    }
    public string FirstName {
        get { return _firstName; }
    }
    public string LastName {
        get { return _lastName; }
    }

    public User(int _userId, string _firstName, string _lastName) {
        this._userId = _userId;
        this._firstName = _firstName;
        this._lastName = _lastName;
    }

    public User() {}

    [AjaxMethod()]
    public static User GetUser(int userId) {
        // 這裡可以換成實際的資料庫查詢
        return new User(userId, "Michael", "Schwarz");
    }
}

接著用 RegisterTypeForAJax 註冊 GetUser 的代理:

private void Page_Load(object sender, EventArgs e) {
    Utility.RegisterTypeForAJax(typeof(User));
}

之後即可在客戶端非同步呼叫 GetUser,回應中的值是一個物件,公開與伺服器端相同的屬性(FirstName、LastName、userId)。

自訂轉換器

包裝器能處理大量 .NET 型別,但對不在此列且無法正確序列化的型別,它只會呼叫 ToString()。為了避免這種粗暴的降级,Ajax.NET 允許開發者建立物件轉換器,在伺服器與用戶端之間平滑傳遞複雜物件。

其他事項

在其他類中註冊函數

前面的範例把伺服器端函數放在頁面背後的程式碼裡,但沒有理由不能放到獨立類別檔。包裝器的運作方式是:在指定類中找出所有帶 AjaxMethod 特性的方法;需要哪些類,就透過第二個 script 標籤指定,並以 Ajax.Utility.RegisterTypeForAJax 註冊。把伺服器端函數獨立成一個類是相當合理的做法:

Public Class AjaxFunctions

    <Ajax.AjaxMethod()> _
    Public Function Validate(username As String, passWord As String) As Boolean
        ' 執行驗證邏輯
        ' 回傳結果
    End Function

End Class

註冊時傳入類的型別而非頁面即可:

private void Page_Load(object sender, EventArgs e) {
    Ajax.Utility.RegisterTypeForAjax(typeof(AjaxFunctions));
    // ...
}

請注意,客戶端代理的名稱是「類名.伺服器端函數名」。因此若把 ServerSideAdd 放進 AjaxFunctions 類,客戶端呼叫就該寫成 AjaxFunctions.ServerSideAdd(1, 2)。

代理究竟如何運作

Ajax 工具產生的第二個 script 標籤(也可以手寫)會帶上頁面的命名空間、類名與組件名稱。根據這些資訊,Ajax.PageHandlerFactory 就能用反射取得帶有特定特性的函數細節:找出所有標了 AjaxMethod 的方法,讀取它們的簽章(回傳型別、名稱、參數),據此產生必要的客戶端代理。

具體來說,包裝器會建立一個與類同名的 JavaScript 物件,由它提供代理。也就是說,給定一個含 AjaxMethod 的 ServerSideAdd 的伺服器端類 AjaxFunctions,你就會得到一個公開 ServerSideAdd 函數的 AjaxFunctions JavaScript 物件。把瀏覽器指向第二個 script 標籤的路徑,就能直接看到這個動作的成果。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved