AJAX学习摘记——客户端访问WebService（上）

最新推荐文章于 2021-08-05 12:45:52 发布

原创最新推荐文章于 2021-08-05 12:45:52 发布 · 1.8k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#webservice #ajax #javascript #server #button #asp

本文介绍客户端如何访问WebService及PageMethod的基础知识，涵盖错误处理及复杂数据类型使用等内容。通过实例演示了WebService方法的定义与调用流程，以及PageMethod的使用方法。

客户端访问WebService（上）

基本使用方式

赵劼

MSDN特邀讲师

jeffz@live.com

本次课程内容包括
    • 客户端访问WebService基础
    • 客户端访问PageMethod基础
    • 错误处理
    • 复杂数据类型使用基础
    • 客户端代理使用细节

收听本次课程需具备的条件
• 了解.NET Framework开发
• 熟悉JavaScript开发（应知道怎么调用方法，回调函数的概念）

一、服务器端释放WebService方法
    • 编写一个普通的ASP.NET WebService
    • 为WebService类添加自定义属性标记
        – ScriptServiceAttribute
    • 释放WebService方法
        – 访问级别为public（首先基本public权限的方法）
        – 使用WebMethodAttribute进行标记
    • 为页面中的ScriptManager(Proxy)引入asmx文件

二、客户端访问WebService
    • [Namespaces.]ClassName.MethodName （命名空间 -> 类 -> 方法）
    • 依次传入参数
    • 传入一个方法做为成功后的回调函数
    • 即使没有返回值也会调用回调函数（因为它只是通知你事件已经处理完毕）

DEMO 1 （客户端访问WebService基础）

WebServiceFoundation.asmx

<% @ WebService Language = " C# " Class = " Sample.WebServiceFoundation " %>

using System;

using System.Web;

using System.Web.Services;

using System.Web.Services.Protocols;

using System.Web.Script.Services;

namespace Sample

{

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

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[ScriptService] //要释放时此处必须标写

public class WebServiceFoundation : System.Web.Services.WebService //继承WebService类

{

[WebMethod]

public int GetRandom()

{

return new Random(DateTime.Now.Millisecond).Next();

}

[WebMethod]

public int GetRangeRandom(int minValue, int maxValue)

{ //在一个区间获得一个随机数

return new Random(DateTime.Now.Millisecond).Next(minValue, maxValue);

}

1_WebServiceFoundation.aspx

<% @ Page Language = " C# " AutoEventWireup = " true " CodeFile = " 1_WebServiceFoundation.aspx.cs " Inherits = " _1_WebServiceFoundation " %>

<! DOCTYPE html PUBLIC " -//W3C//DTD XHTML 1.0 Transitional//EN " " http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd " >

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

< head runat = " server " >

< title > Untitled Page </ title >

</ head >

< body >

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

< asp:ScriptManager ID = " ScriptManager1 " runat = " server " ScriptMode = " Debug " >

< Services >

< asp:ServiceReference Path = " WebServiceFoundation.asmx " InlineScript = " true " /> // InlineScript 默认为false

</ Services >

</ asp:ScriptManager >

< input type = " button " value = " Get Random " onclick = " getRandom() " />

< input type = " button " value = " Get Range Random " onclick = " getRandom(50, 100) " />

< script language = " javascript " type = " text/javascript " >

function getRandom(minValue, maxValue)

{ //客户端提供一个类似重载的功能

if (arguments.length != 2)

{

Sample.WebServiceFoundation.GetRandom(getRandomSucceeded);

}

else

{

Sample.WebServiceFoundation.GetRangeRandom(minValue, maxValue, getRandomSucceeded);

}

function getRandomSucceeded(result)

{

alert(result);

}

</ script >

</ form >

</ body >

</ html >

arguments：在JavaScript方法被调用时，都会初始化一个arguments这么一个对象，可当作一个数组类使用，但实际上是一个object，存放的就是这个方法调用时实际传入的参数

三、客户端访问PageMethod
    • 服务器端
        – 只能在aspx页面中定义
        – 只能是公开静态方法（static，无法在方法中访问页面控件）
        – 使用WebMethodAttribute标记
        – ScriptManager的EnablePageMethods属性设为true （EnablePageMethods默认为false）
    • 客户端
        – 通过PageMethods.MethodName访问

DEMO 2 （客户端访问PageMethods基础）

2_PageMethods.aspx

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

<! DOCTYPE html PUBLIC " -//W3C//DTD XHTML 1.0 Transitional//EN " " http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd " >

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

< head runat = " server " >

< title > Untitled Page </ title >

</ head >

< body >

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

< asp:ScriptManager ID = " ScriptManager1 " runat = " server " EnablePageMethods ="true" />

< input type = " button " value = " Get Current Time " onclick = " getCurrentTime() " />

< script language = " javascript " type = " text/javascript " >

function getCurrentTime()

{

PageMethods.GetCurrentTime(getCurrentTimeSucceeded);

}

function getCurrentTimeSucceeded(result)

{

alert(result);

}

</ script >

</ form >

</ body >

</ html >

2_PageMethods.aspx.cs

using System;

using System.Data;

using System.Configuration;

using System.Collections;

using System.Web;

using System.Web.Security;

using System.Web.UI;

using System.Web.UI.WebControls;

using System.Web.UI.WebControls.WebParts;

using System.Web.UI.HtmlControls;

using System.Web.Services;

public partial class _2_PageMethods : System.Web.UI.Page

{

protected void Page_Load(object sender, EventArgs e)

{

}

[WebMethod]

public static DateTime GetCurrentTime()

{

return DateTime.UtcNow; //得到一个UTC时间

}

运行结果：

当点击button时将弹出

Mon May 14 15：11：57 UTC+0800 2007

四、错误处理
    • 调用时可以提供一个额外的错误回调函数
    • 包括超时和服务器端抛出的异常
    • 超时只能设置在WebService级别
        – 或者设置在PageMethods对象上
        – 无法在每个Method Call时指定（只能在Page中设定）
    • Sys.Net.WebServiceError （是个类）
        – timedout、message、exceptionType、stackTrace属性
只有timeout为布尔型，其他都为字符型

DEMO 3 （错误处理）

ErrorHandling.asmx