您的位置：首页 > 其它

利用Ajax.dll进行Ajax开发

2010-07-12 23:08 309 查看

0、它是如何工作的

1、创建服务器端函数

2、客户端调用

3、回调函数

4、处理类型

5、会话访问

附录

0、它是如何工作的

利用 Ajax包装器，ASP.NET开发人员可以快速方便的部署很容易利用AJAX功能的页面。

Ajax依靠代理（broker）指派和处理往返服务器的请求，对此，包装器的目的是隐藏 XmlHttpRequest对象的实现，包装器本身通过将.NET函数标记为 Ajax方法来工作。标记之后，AJAX就创建对应的JavaScript函数，这些函数（和任何JavaScript函数一样）作为代理可以在客户端使用 XmlHttpRequest调用。这些代理再映射回服务器端函数。

假设有一个.NET函数：

ublic int Add(int firstNumber, int secondNumber)
{
return firstNumber + secondNumber;
}

包装器将自动创建名为“Add”、带有两个参数的JavaScript函数。使用JavaScript（在客户机上）调用该函数时，请求将传递给服务器并把结果返回给客户机。

1、创建服务器端函数

⑴、项目中引用 Ajax.dll文件。

⑵、编写函数代码

namespace ForAjax
{
public class Example
{
[Ajax.AjaxMethod()]
public static int ServerSideAdd(int firstNumber, int secondNumber)
{
return firstNumber + secondNumber;
}
}
}

函数中包含 [Ajax.AjaxMethod()]属性集。该属性告诉包装器这些方法创建javaScript代理，以便在客户端调用。

2、客户端调用

⑴、网站中引用 Ajax.dll及服务器项目文件。

⑵、web.config中建立HttpHandler

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

注：在 IIS7上部署。

<system.webServer>
<handlers>
<add name="ajax" verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" />
</handlers>
</system.webServer>

⑶、客户端页面调用

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>

<html>
<head>
<script language="javascript" src="ajax/common.ashx"></script>
<script language="javascript" src="ajax/ForAjax.Example,ForAjax.ashx"></script>
<script language="javascript">
var response = Example.ServerSideAdd(100,99);
alert(response.value);
</script>
</head>

<body">
<form id="form1">
</form>
</body>
</html>

其中，"ajax/ForAjax.Example,ForAjax.ashx" 为 "ajax/Namespace.PageClass,AssemblyName.ashx"格式。可以在浏览器中手工导航到src路径（查看源代码，复制粘贴路径）检查是否一切正常。

通过 web.config，我们已经保证所有对 ajax/*.ashx的请求都由自定义的 Ajax包装器处理。包装器负责创建带有两个参数的 JavaScript函数 Sample.ServerSideAdd以供前台调用。

3、回调函数

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——xml http请求的原始响应。
Context——上下文对象。

4、处理类型

Ajax包装器不仅能处理ServerSideAdd函数所返回的整数。它目前支持 integers、strings、double、booleans、DateTime、DataSets和DataTables，以及自定义类和数组等基本类型。其他所有类型都返回它们的ToString值。

⑴、返回的 DataSets

和真正的.NET DataSet差不多。假设一个服务器端函数返回DataSet，我们可以通过下面的代码在客户端显示其中的内容：

<script language="JavaScript">
//Asynchronous call to the mythical "GetDataSet" server-side
function function getDataSet(){
AjaxFunctions.GetDataSet(GetDataSet_callback);
}

function GetDataSet_callback(response){
var ds = response.value;
if(ds != null && typeof(ds) == "object" && ds.Tables != null){
var s = new Array();
s[s.length] = "<table border=1>";
for(var i=0; i<ds.Tables[0].Rows.length; i++){
s[s.length] = "<tr>";
s[s.length] = "<td>" + ds.Tables[0].Rows[i].FirstName + "</td>";
s[s.length] = "<td>" + ds.Tables[0].Rows[i].Birthday + "</td>";
s[s.length] = "</tr>";
}
s[s.length] = "</table>";
tableDisplay.innerHTML = s.join("");
}
else {
alert("Error. [3001] " + response.request.responseText);
}
}
</script>

⑵、返回自定义类

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)
{
//Replace this with a DB hit or something :)
return new User(userId, "Michael", "Schwarz");
}
}

我们可以通过调用 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）。

⑶、[b]返回 Unicode字符[/b]

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;
}

⑷、自定义转换器

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

5、会话访问

[Ajax.AjaxMethod(Ajax.HttpSessionStateRequirement.Read)]
public void DocumentReleased()
{
if (System.Web.HttpContext.Current.Session["DocumentsWaiting"] == null)
{
//...
}
}

附录：

ASP.NET下利用ajax.dll进行Ajax开发

ASP.NET 调味品：AJAX

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签：

相关文章推荐

新的分享

章节导航