這是依據 Ajax.Net 作者提供的範例改寫的版本,重點示範兩件事:客戶端可以把自訂類別的物件送到伺服器端,伺服器端也可以把類別實例回傳給客戶端。我把作者的程式碼精簡過,aspx 端不另寫 code-behind 檔,所有伺服器端方法集中在一個 .cs 檔裡,並保留必要註解。
實際用起來會發現這個框架相當單純,就學習曲線而言甚至比 Atlas 或無刷新回呼更容易上手。以下程式碼在 IE6 與 Firefox 皆測試通過。
<%@ Page Language="C#"%>
<script runat="server">
void Page_Load(object sender, EventArgs e)
{
// 把 MyDemo 命名空間下的 Demo 類別註冊給 Ajax 使用
AjaxPro.Utility.RegisterTypeForAJax(typeof(MyDemo.Demo));
}
</script>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server"><title>Untitled Page</title></head>
<body>
<form id="form1" runat="server">
<div>
<input type="button" value="取回一個類別物件" /><br/>
<input type="button" value="取回繼承類別的物件" /><br/>
<input type="button" value="把類別物件送給伺服器" />
</div>
</form>
<script type="text/javascript">
function getClass() {
MyDemo.Demo.GetMyClass(getMyClass);
}
function getMyClass(ret) {
var a = ret.value;
alert(a.FirstName);
}
function getInheritedClass() {
MyDemo.Demo.GetInheritedClass(getInhClass);
}
function getInhClass(tg) {
var a = tg.value;
alert(a.LastName + "\n" + a.gid);
}
function putClass() {
// 先呼叫伺服器方法拿一個物件回來
var p = MyDemo.Demo.GetMyClass().value;
p.FirstName = "老鼠是";
// 第一個參數是伺服器方法要的參數,第二個是接收結果的 JS 函式
MyDemo.Demo.PutClass(p, putMyClass);
}
function putMyClass(dsf) {
var a = dsf.value;
alert(a.FirstName + "\n" + a.LastName + "的徒弟!");
}
</script>
</body>
</html>
只有需要被客戶端呼叫的方法才要加上 [AjaxPro.AjaxMethod]。
using System;
using AJaxPro;
namespace MyDemo
{
public class MyClass
{
public MyClass() {}
public string FirstName = "";
public string LastName = "";
public int Age = 0;
}
// 繼承自 MyClass,因此具備父類別的所有公開屬性
public class MyInheritedClass : MyClass
{
public double Size = 0.0;
public Guid gid = Guid.Empty;
}
public class Demo
{
public Demo() {}
[AjaxPro.AjaxMethod]
public MyClass GetMyClass()
{
MyClass c = new MyClass();
c.FirstName = "老鼠";
c.LastName = "吳旗娃";
c.Age = 30;
return c;
}
// 回傳繼承類別的實例,客戶端一樣能取得父類別的公開屬性
[AjaxPro.AjaxMethod]
public MyInheritedClass GetInheritedClass()
{
MyInheritedClass c = new MyInheritedClass();
c.FirstName = "老鼠";
c.LastName = "吳旗娃";
c.Age = 30;
c.Size = 4.5;
c.gid = Guid.NewGuid();
return c;
}
// 接收客戶端傳來的類別物件,處理後再回傳一個類別物件
[AjaxPro.AjaxMethod]
public MyClass PutClass(MyClass c)
{
c.LastName = "吳旗娃師傅";
return c;
}
}
}
整個流程的關鍵其實只有註冊與標記兩步:Page_Load 裡註冊型別,方法上標上 AjaxMethod,其餘的序列化工作都由框架代勞。客戶端拿到的 value 就是伺服器物件的鏡像,直接讀屬性即可,不需要自己解析 XML。