ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化

摘要

通过前两篇文章，我们知道使用了ASP.NET AJAX框架后，在JavaScript中调用后台WebService方法非常方便，几乎可以看做是“直接调用”。那么，这里引出了一个问题：调用方法就牵扯到参数的传递，而JavaScript和C#毕竟是两种不同的语言，数据类型怎么沟通？简单型数据类型还好说，如果我们需要的参数是个复杂类型呢？如分层架构中经常用到实体类做参数，我们在后台定义实体类类型，但是JavaScript可不知道这种定义，也没有相应数据类型，那么要如何解决这个问题呢？再进一步，如果需要的参数是个泛型集合呢？在JavaScript中又要如何表示这种类型？这一篇将解决这些问题。

先来看ASP.NET AJAX给你变个魔术

我们都知道，使用分层架构开发系统时，使用实体类作为参数很很普遍的。那么如果我们需要调用的某个后台方法中需要实体类做参数，应该如何进行呢？毕竟C#中定义的实体类在JavaScript中可不认识啊。先不要着急，跟我做以下几步，我们一起来看个魔术。

1.新建一个ASP.NET AJAX Enabled Web Site工程，并添加系统文件夹App_Code。

2.我们在App_Code里新建一个C#类文件StudentInfo.cs，其内容如下：

StudentInfo.cs:

using System;
2

[Serializable]
4

public class StudentInfo
5

{
6

private string _name;
7

private int _age;
8

private string _college;
9

public StudentInfo() { }
11

public string Name
13

{
14

get { return this._name; }
15

set { this._name = value; }
16

}
17

public int Age
19

{
20

get { return this._age; }
21

set { this._age = value; }
22

}
23

public string College
25

{
26

get { return this._college; }
27

set { this._college = value; }
28

}
29

}

这是一个典型的实体类，相信做过分层架构的朋友一定经常使用到类似的代码。这里要特别注意两点：一是这个类上面有一个[Serializeable]属性，这表明此类可以被序列化，另外就是这个类有一个空的构造函数。

3.接着，我们在网站根目录下添加一个WebService：StudentService.asmx，其代码如下：

StudentService.cs:

using System;
2

using System.Web;
3

using System.Collections;
4

using System.Web.Services;
5

using System.Web.Services.Protocols;
6

using System.Web.Script.Services;
7

[WebService(Namespace = "http://tempuri.org/")]
9

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
10

[ScriptService]
11

[GenerateScriptType(typeof(StudentInfo))]
12

public class StudentService : System.Web.Services.WebService
13

{
14

public StudentService() { }
15

[WebMethod]
17

public string ShowStudentInfo(StudentInfo student)
18

{
19

return "学生姓名：" + student.Name + "<br />年龄：" + student.Age + "<br />所在院系：" + student.College;
20

}
21

}

ShowStudentInfo这个方法接收一个StudentInfo类型的参数，并根据这个实体类的信息组合成一段字符串返回。

4.接着，在网站根目录下新建一个ajax.js文件，内容如下：

ajax.js:

function btnShowStudentInfo_onClick()
2

{
3

var student=new StudentInfo();
4

student.Name="张无忌";
5

student.Age="20";
6

student.College="计算机学院";
7

StudentService.ShowStudentInfo(student,CallBackFunction);
9

}
10

function CallBackFunction(responseText)
12

{
13

$get("result").innerHTML=responseText;
14

}

这里我们大胆的直接初始化了一个StudentInfo，为什么说大胆呢？不要忘了，我们的StudentInfo类型可是在C#中定义的，JavaScript里可压根没有这个类型，当时我们这里却好像在写C#似的，不但初始化了这个类，还给其中成员赋值，并且当作参数传给了后台方法。这样能成功吗？我们接着看看吧。

5.Default.aspx作为主页，我们添加如下内容：

Default.aspx:

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4

<html xmlns="http://www.w3.org/1999/xhtml">
5

<head runat="server">
6

<title>复杂类型自动转换测试</title>
7

</head>
8

<body>
9

<form id="form1" runat="server">
10

<asp:ScriptManager ID="ScriptManager1" runat="server">
11

<Scripts>
12

<asp:ScriptReference Path="~/ajax.js" />
13

</Scripts>
14

<Services>
15

<asp:ServiceReference Path="~/StudentService.asmx" />
16

</Services>
17

</asp:ScriptManager>
18

<div>
19

<input id="btnShowStudentInfo" type="button" value="ShowStudentInfo" onclick="btnShowStudentInfo_onClick()" />
20

<div id="result"></div>
21

</div>
22

</form>
23

</body>
24

</html>

这里就不用做过多解释了，看过前两篇的朋友肯定很容易就明白这段代码是什么意思。运行后，我们单击按钮，得到如下效果：

可以看到，不仅程序运行没有报错，而且我们在JavaScript中定义的实体类被传到后台，并神奇的变成了C#实体类，作为参数完成了数据传递工作。运行结果非常令人满意。

魔术揭秘

在上面的例子中，我们没有在JavaScript定义StudentInfo，更没有写代码把JavaScript实体类转换成C#实体类，但是程序正确执行了。很显然，有人替我们做了这一切，那是谁呢？当然是我们亲爱的ASP.NET AJAX。这就是这个框架另一项神奇的功能：前后台间数据类型自动转换，这个转换可不仅包括简单类型，还包括像实体类这样的复杂类型。那么，其工作原理是什么呢？

仔细看StudentService.cs的代码，在类定义的上面，有一个[GenerateScriptTyep(typeof(StudentInfo))] 属性，秘诀就在这里。当我们给WebService类加上这条属性时，ASP.NET AJAX会在运行时自动为我们生成一个JavaScript版本的StudentInfo类，这个类的所有属性都和C#版的一模一样。所以，我们在JavaScript中实例化并赋值的其实是一个JavaScript版的StudentInfo。而后，当我们调用ShowStudentInfo方法时，ASP.NET AJAX框架会自动将JavaScript版的StudentInfo序列化成JOSN字符串，然后传到后台，后台再将这段字符串反序列化成C#版的StudentInfo，并作为参数传递给ShowStudentInfo，从而顺利完成工作。

当然，如果某个后台方法返回一个StudentInfo类型的返回值，它也可以准确无误从C#传到JavaScript中。也就是说，序列化和反序列化都是双向的。

自动转换的条件

知道了上述原理，那么如何才能自动转换呢？或者说具备什么条件的复杂类型才可以自动转换呢？大约有以下几点：

1.需要在WebService中使用[GenerateScriptTyep()]属性指明要自动生成的复杂数据类型。

2.该复杂类型必须有一个无参数的构造函数。

3.该复杂类型的所有公有属性必须有get和set方法。

另外值得注意的是，生成的JavaScript版本类只包含原类的公有属性，而私有属性和方法是不会映射过来的。应该说，这个技术对使用分层架构的应用特别有用，因为可以直接在客户端使用服务器端的实体类进行数据传输。

ASP.NET AJAX到底能自动转换哪些数据类型？

1.基本类型将被转换为基本类型。如整形、浮点型、字符串、布尔型、DateTime等。（全自动转换）

2.枚举类型将被转换为枚举类型。（全自动转换）

3.复杂类型将转换为同名复杂类型，但只保留公有属性。（需要使用[GenerateScriptTyep(typeof(TypeName))]属性声明）

4.数组、泛型集合将转换为数组。（全自动转换）

5.DataTable将转换为JavaScript版的DataTable，但是需要ASP.NET Futures CTP的支持。

结束语

这一篇中介绍了ASP.NET AJAX中非常有用的一个特性：数据类型自动转换。通过这个功能，使得前台可以更方便的调用后台程序。尤其是使用实体类传递数据会变得非常方便。在下一篇中，将介绍客户端组件的概念、使用客户端组件思想进行JavaScript开发以及简化的DOM操作。

本文用到的实例可以在这里下载：AutoConvertionTest.rar

主要参考文献

[1] 陈黎夫，ASP.NET AJAX程序设计-第II卷：客户端，人民邮电出版社，2007年10月

Tag标签: .NET,WEB,Ajax,ASP.NET AJAX

posted on 2008-07-24 00:07 T2噬菌体阅读(1572) 评论(26) 编辑收藏所属分类: .NET 、Ajax 、Web Development

与我联系

搜索

常用链接

留言簿(2)

我参加的小组

我的标签

随笔分类

随笔档案

积分与排名

最新评论