我们可以通过调用RegisterTypeForAjax注册GetUser代理：

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

这样就可以在客户端异步调用GetUser：

<script language="javascript">
function getUser(userId){
User.GetUser(GetUser_callback); 
}
function GetUser_callback(response){
if (response != null && response.value != null){
var user = response.value; 
if (typeof(user) == "object"){ 
alert(user.FirstName + " " + user.LastName); 
}
}
}
getUser(1); 
</script>

响应中返回的值实际上是一个对象，公开了和服务器端对象相同的属性（FirstName、LastName和UserId）。

自定义转换器

我们已经看到，Ajax .NET包装器能够处理很多不同的.NET类型。但是除了大量.NET类和内建类型以外，包装器对不能正确返回的其他类型仅仅调用ToString()。为了避免这种情况，Ajax .NET包装器允许开发人员创建对象转换器，用于在服务器和客户机之间平滑传递复杂对象。

其他事项

在其他类中注册函数

上面的例子中，我们的服务器端函数都放在执行页面背后的代码中。但是，没有理由不能把这些函数放在单独的类文件中。要记住，包装器的工作方式是在指定类中发现所有带Ajax.AjaxMethod的方法。需要的类通过第二个脚本标签指定。使用Ajax.Utility.RegisterTypeForAjax，我们可以指定需要的任何类。比如，将我们的服务器端函数作为单独的类是合情合理的：

Public Class AjaxFunctions
<Ajax.AjaxMethod()> _
Public Function Validate(username As String, password As String) As Boolean
''do something
''Return something
End Function
End Class

通过指定类的类型而不是页面就可以让Ajax包装器创建代理：

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

要记住，客户端代理的名称是<ClassName>.<ServerSideFunctionName>。因此，如果ServerSideAdd函数放在上面虚构的AjaxFunctions类中，客户端调用就应该是： AjaxFunctions.ServerSideAdd(1,2)。

代理到底是如何工作的

Ajax工具生成的第二个脚本标签（也可以手工插入）传递了页面的名称空间、类名和程序集。根据这些信息，Ajax.PageHandlerFactory就能够使用反射得到具有特定属性的任何函数的详细信息。显然，处理函数查找具有AjaxMethod属性的函数并得到它们的签名（返回类型、名称和参数），从能够创建必要的客户端代理。具体而言，包装器创建一个和类同名的JavaScript对象，该对象提供代理。换句话说，给定一个带有Ajax ServerSideAdd方法的服务器端类AjaxFunctions，我们就会得到公开ServerSideAdd函数的AjaxFunction JavaScript对象。如果将浏览器指向第二个脚本标签的路径就会看到这种动作。

返回Unicode字符

Ajax .NET包装器能够从服务器向客户机返回Unicode字符。为此，数据在返回之前必须在服务器上用html编码。比如：

[Ajax.AjaxMethod]
public string Test1(string name, string email, string comment){
string html = ""; 
html += "Hello " + name + "<br>"; 
html += "Thank you for your comment<b>"; 
html += System.Web.HttpUtility.HtmlEncode(comment); 
html += "</b>."; 
return html; 
}

SessionState

服务器端函数中很可能需要访问会话信息。为此，只需要通过传递给Ajax.AjaxMethod属性的一个参数告诉Ajax启用这种功能。

在考察包装器会话能力的同时，我们来看看其他几个特性。这个例子中我们有一个文档管理系统，用户编辑的时候会对文档加锁。其他用户可以请求在文档可用的时候得到通知。如果没有AJAX，我们就只能等待该用户再次返回来检查请求的文档是否可用。显然不够理想。使用支持会话状态的Ajax就非常简单了。

首先来编写服务器端函数，目标是循环遍历用户希望编辑的documentId（保存在会话中）并返回所有已释放的文档。

[Ajax.AjaxMethod(HttpSessionStateRequirement.Read)]
public ArrayList DocumentReleased(){
if (HttpContext.Current.Session["DocumentsWaiting"] == null){
return null; 
}
ArrayList readyDocuments = new ArrayList(); 
int[] documents = (int[])HttpContext.Current.Session["DocumentsWaiting"]; 
for (int i = 0; i 〈 documents.Length; ++i){
Document document = Document.GetDocumentById(documents[i]); 
if (document != null && document.Status == DocumentStatus.Ready){
readyDocuments.Add(document); 
} 
}
return readyDocuments; 
}
}

要注意，我们指定了HttpSessionStateRequirement.Read值（还可以用Write和ReadWrite）。

现在编写使用该方法的JavaScript：

<script language="javascript">
function DocumentsReady_CallBack(response){
if (response.error != null){
alert(response.error); 
return; 
}
if (response.value != null && response.value.length > 0){
var div = document.getElementById("status"); 
div.innerHTML = "The following documents are ready!<br />"; 
for (var i = 0; i （response.value.length; ++i){
div.innerHTML += "<a href=\"edit.aspx?documentId=" + response.value[i].DocumentId + "\">" + response.value[i].Name + "</a>〈br />"; 
} 
}
setTimeout(''page.DocumentReleased(DocumentsReady_CallBack)'', 10000); 
}
〈/script> 
〈body onload="setTimeout(''Document.DocumentReleased(DocumentsReady_CallBack)'', 10000); ">

结束语

AJAX技术已经催生了原来只有桌面开发才具备的健壮而丰富的Web界面。Ajax .NET包装器让您很容易就能利用这种新的强大技术。请注意，Ajax .NET包装器和文档仍在开发之中。