让JavaScript和C#无障碍沟通：数据类型自动转换&序列化
2010-04-13 11:53
579 查看
摘要
我们知道使用了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:
1using System;
2
3[Serializable]
4public class StudentInfo
5{
6 private string _name;
7 private int _age;
8 private string _college;
9
10 public StudentInfo() { }
11
12 public string Name
13 {
14 get { return this._name; }
15 set { this._name = value; }
16 }
17
18 public int Age
19 {
20 get { return this._age; }
21 set { this._age = value; }
22 }
23
24 public string College
25 {
26 get { return this._college; }
27 set { this._college = value; }
28 }
29}
这是一个典型的实体类，相信做过分层架构的朋友一定经常使用到类似的代码。这里要特别注意两点：一是这个类上面有一个[Serializeable]属性，这表明此类可以被序列化，另外就是这个类有一个空的构造函数。
3.接着，我们在网站根目录下添加一个WebService：StudentService.asmx，其代码如下：
StudentService.cs:
1using System;
2using System.Web;
3using System.Collections;
4using System.Web.Services;
5using System.Web.Services.Protocols;
6using System.Web.Script.Services;
7
8[WebService(Namespace = "http://tempuri.org/")]
9[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
10[ScriptService]
11[GenerateScriptType(typeof(StudentInfo))]
12public class StudentService : System.Web.Services.WebService
13{
14 public StudentService() { }
15
16 [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文件，内容如下：
ft: 0px; line-height: normal; ">ajax.js:
1function btnShowStudentInfo_onClick()
2{
3 var student=new StudentInfo();
4 student.Name="张无忌";
5 student.Age="20";
6 student.College="计算机学院";
7
8 StudentService.ShowStudentInfo(student,CallBackFunction);
9}
10
11function CallBackFunction(responseText)
12{
13 get("result").innerHTML=responseText;
14}
这里我们大胆的直接初始化了一个StudentInfo，为什么说大胆呢？不要忘了，我们的StudentInfo类型可是在C#中定义的，JavaScript里可压根没有这个类型，当时我们这里却好像在写C#似的，不但初始化了这个类，还给其中成员赋值，并且当作参数传给了后台方法。这样能成功吗？我们接着看看吧。
5.Default.aspx作为主页，我们添加如下内容：
Default.aspx:
1<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
2
3<!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>复杂类型自动转换测试http://dwww.cn </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月
来源：http://www.cnblogs.com/leoo2sk
我们知道使用了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:
1using System;
2
3[Serializable]
4public class StudentInfo
5{
6 private string _name;
7 private int _age;
8 private string _college;
9
10 public StudentInfo() { }
11
12 public string Name
13 {
14 get { return this._name; }
15 set { this._name = value; }
16 }
17
18 public int Age
19 {
20 get { return this._age; }
21 set { this._age = value; }
22 }
23
24 public string College
25 {
26 get { return this._college; }
27 set { this._college = value; }
28 }
29}
这是一个典型的实体类，相信做过分层架构的朋友一定经常使用到类似的代码。这里要特别注意两点：一是这个类上面有一个[Serializeable]属性，这表明此类可以被序列化，另外就是这个类有一个空的构造函数。
3.接着，我们在网站根目录下添加一个WebService：StudentService.asmx，其代码如下：
StudentService.cs:
1using System;
2using System.Web;
3using System.Collections;
4using System.Web.Services;
5using System.Web.Services.Protocols;
6using System.Web.Script.Services;
7
8[WebService(Namespace = "http://tempuri.org/")]
9[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
10[ScriptService]
11[GenerateScriptType(typeof(StudentInfo))]
12public class StudentService : System.Web.Services.WebService
13{
14 public StudentService() { }
15
16 [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文件，内容如下：
ft: 0px; line-height: normal; ">ajax.js:
1function btnShowStudentInfo_onClick()
2{
3 var student=new StudentInfo();
4 student.Name="张无忌";
5 student.Age="20";
6 student.College="计算机学院";
7
8 StudentService.ShowStudentInfo(student,CallBackFunction);
9}
10
11function CallBackFunction(responseText)
12{
13 get("result").innerHTML=responseText;
14}
这里我们大胆的直接初始化了一个StudentInfo，为什么说大胆呢？不要忘了，我们的StudentInfo类型可是在C#中定义的，JavaScript里可压根没有这个类型，当时我们这里却好像在写C#似的，不但初始化了这个类，还给其中成员赋值，并且当作参数传给了后台方法。这样能成功吗？我们接着看看吧。
5.Default.aspx作为主页，我们添加如下内容：
Default.aspx:
1<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
2
3<!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>复杂类型自动转换测试http://dwww.cn </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月
来源：http://www.cnblogs.com/leoo2sk
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化
- ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化
- ASP.NET AJAX客户端编程教程(3)——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化
- ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化（转载）
- ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化
- [导入]ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化
- 使用ASP.NET AJAX异步调用Web Service和页面中的类方法（10）：服务器端和客户端数据类型的自动转换：以XML方式序列化数据、小结
- JavaScript基础之数据类型转换 、运算符 &表达式
- ASP.NET MVC WebApi 返回数据类型序列化控制（json,xml) 用javascript在客户端删除某一个cookie键值对 input点击链接另一个页面，各种操作。 C# 往线程里传参数的方法总结 TCP/IP 协议 用C#+Selenium+ChromeDriver 生成我的咕咚跑步路线地图 (转)值得学习百度开源70+项目
- javascript之数据类型、数据类型的转换、&&和||
- 服务器端和客户端数据类型的自动转换：以XML方式序列化数据
- Javascript 自动数据类型转换机制
- 使用ASP.NET AJAX异步调用Web Service和页面中的类方法（10）：服务器端和客户端数据类型的自动转换：以XML方式序列化数据、小结
- C#变量、输入、数据类型的自动转换
- javascript各种类型数据在表达式中转换成布尔型值的规则总结
- javascript数据类型隐式转换
- javascript中数据类型的隐式转换
- 痛快-代码生成之数据类型和C#类弄转换
- 数据类型的自动转换
- yii2 Ecommerce 特殊字段的mongo数据处理。不能通过info配置自动转换类型的数据