日期:2009-12-05  浏览次数:20568 次

 声明一个XML Web服务

  当你使用ASP.NET创建一个XML Web服务时,你要把所需的@_WebService指令放到.asmx文件的最顶端。.asmx文件的存在和@_ WebService指令与所实现的XML Web服务的URL地址相关。接下来,你实现XML Web服务类来定义XML Web服务客户端可见的方法和数据类型。最后,你把你的XML Web服务逻辑添加到那些方法上,以便处理XML Web服务请求和返回的响应。你定义的XML Web服务类可以直接被包含在.asmx文件中,也可以包含在一个单独的文件中。如果你使用一个独立的文件,它必须被编译为二进制码。你可以选择应用一个WebService属性到这个类上,来实现XML Web服务。实现XML Web服务的类可以继承于WebService类。

  声明一个XML Web服务,这个服务的实现存在于同一个文件。

  添加一个@_WebService指令到一个.asmx文件的顶部,规定在这个实现中实现XML Web服务的类和程序语言。

  Class属性可以被设置为和@_WebService指令同一个汇编文件,或者是单独汇编文件中的一个类。如果这个类存在于一个独立汇编文件中,它必须放在XML Web服务所在的Web应用程序目录下的\Bin目录中。Language属性可以设置为C#、VB和JS,分别表示C#、Visual Basic.NET和JScript.NET。

  下列代码示例设置@_ WebService指令的Language属性为C#,Class属性为MyMath,保存在同一个文件中。

<%@ WebService Language="C#" Class="MyMath" %>
using System.Web.Services;
public class MyMath {
[ WebMethod ]
public int Add(int num1, int num2) {
return num1+num2;
}
}

  声明一个XML Web服务,这个服务的实现存在于一个汇编文件中。

  添加一个@_WebService指令到一个.asmx文件的顶部,规定实现XML Web服务的类,汇编文件中包含的实现和在这个实现中使用的程序语言。

  下面的@_WebService指令是一个.asmx文件中唯一的一行代码,指定了MyName.MyWebService类存在于XML Web服务的Web应用程序下\Bin目录中的MyAssembly汇编文件中。

[C#]
<%@ WebService Language="C#" Class="MyName.MyWebService,MyAssembly" %>
[Visual Basic]
<%@ WebService Language="VB" Class="MyName.MyWebService,MyAssembly" %>

  声明一个XML Web服务,这个服务的实现存在于一个汇编文件中。

  添加一个@_WebService指令到一个.asmx文件的顶部,规定实现XML Web服务的类,汇编文件中包含的实现和在这个实现中使用的程序语言。

  下面的@_WebService指令是一个.asmx文件中唯一的一行代码,指定了MyName.MyWebService类存在于XML Web服务的Web应用程序下\Bin目录中的MyAssembly汇编文件中。
  注意:如果你不在@_ WebService指令中指定一个汇编,那么ASP.NET在XML Web服务第一次被访问的时候搜寻存放XML Web服务的Web应用程序的\Bin目录下汇编文件的列表。所以,如果你提供汇编文件名,你将改善第一次访问时的系统性能。

  应用WebService属性

  通过应用可选的WebService属性到实现一个XML Web服务的类上,你可以使用一个描述XML Web服务的字符串来设置这个XML Web服务的默认XML域名空间。

  强烈建议这个默认域名空间(此处为http://tempuri.org)在XML Web服务公开使用前被修改。这是很重要的,因为你的XML Web服务必须和其他的无意中使用默认值作为域名空间的XML Web服务区分开来。

  设置成员XML Web服务的XML域名空间

  应用一个WebService属性到实现XML Web服务的类,设置Namespace属性。

  下面的代码示例设置XML域名空间为http://www.contoso.com/。

[C#]
<%@ WebService Language="C#" Class="Math" Debug=true%>
using System.Web.Services;
using System;

[WebService(Namespace="http://www.contoso.com/")]
public class Math {
 [ WebMethod ]
 public int Add(int num1, int num2) {
  return num1+num2;
 }
}
[Visual Basic]
<%@ WebService Language="VB" Class="Math"%>
Imports System.Web.Services
Imports System

<WebService(Namespace:="http://www.contoso.com/")> _
Public Class Math
 <WebMethod()> Public Function Add(num1 As Integer, num2 As Integer) As Integer
 Return num1 + num2
End Function
End Class

  从WebService类衍生

  使用ASP.NET创建的实现一个XML Web服务的类可以选择性地衍生于WebService类来获得访问公共的ASP.NET对象,例如Application、Session、User和Context的权限。Application和Session属性提供保存和接收Web应用程序的生命周期或一个特定的会话的状态的权限。想获得关于状态的更多的信息,请看在使用ASP.NET创建的XML Web服务中管理状态一节。User属性包含了XML Web服务调用者的身份。XML Web服务可以使用调用者身份来判定请求是否被授权。有关验证的更多信息,请看加强XML Web服务安全一节。Context属性提供了取得XML Web服务客户端请求的所有特定HTTP信息的权限。

   下面的代码示例使用Context属性来获得服务器上的请求时间。

[C#]
<%@ WebService Language="C#" Class="Util" %>
using System;
using System.Web.Services;

public class Util: WebService {
 [ WebMethod(Description="Returns the time as stored on the Server",EnableSession=false)]
 public string Time()
 {
  return Context.Timestamp.TimeOfDay.ToString();
 }
}
[Visual Basic]
<%@ WebService Language="VB" Class="Util"