WebMethod详解

作者在 2008-04-28 18:33:12 发布以下内容
WebMethod有6个属性:
1) Description:


是对WebService方法描述的信息。就像webservice方法的功能注释,可以让调用者看见
的注释。


eg:


[WebMethod(Description="Function:Hello World") ]
public string HelloWorld()
{
return "Hello World";
}

2)EnableSession:


指示webservice否启动session标志,主要通过cookie完成的,默认false。


eg:


public static int i=0;
[WebMethod(EnableSession=true)]
public int Count()
{
i=i+1;
return i;
}

3)MessageName:


主要实现方法重载后的重命名:


eg:


public static int i=0;
[WebMethod(EnableSession=true)]
public int Count()
{
i=i+1;
return i;
}


[WebMethod(EnableSession=true,MessageName="Count1")]
public int Count(int da)
{
i=i+da;
return i;
}



通过count访问的是第一个方法,而通过count1访问的是第二个方法!


4)TransactionOption:

指示 XML Web Services 方法的事务支持。

由于 HTTP 协议的无状态特性,XML Web services 方法只能作为根对象参与事务。

如果 COM 对象与 XML Web services 方法参与相同的事务,并且在组件服务管理工
具中被标记为在事务内运行,XML Web services 方法就可以调用这些 COM 对象。
如果一个 TransactionOption 属性为 Required 或 RequiresNew 的 XML Web services
方法调用 另一个 TransactionOption 属性为 Required 或 RequiresNew 的 XML Web services 方法,
每个 XML Web services 方法将参与它们自己的事务,因为XML Web services 方法只能用作事务中的
根对象。


如果异常是从 Web 服务方法引发的或未被该方法捕获,则自动放弃该事务。如果未发生异常,则自动提
交该事务,除非该方法显式调用 SetAbort。


禁用
指示 XML Web services 方法不在事务的范围内运行。当处理请求时,将在没有事务
的情况下执行 XML Web services 方法。
[WebMethod(TransactionOption= TransactionOption.Disabled)]

NotSupported
指示 XML Web services 方法不在事务的范围内运行。当处理请求时,将在没有事务的
情况下执行 XML Web services 方法。
[WebMethod(TransactionOption= TransactionOption.NotSupported)]
 

如果有事务,指示 XML Web services 方法在事务范围内运行。如果没有事务,将在没有事务的情况
下创建 XML Web services。
[WebMethod(TransactionOption= TransactionOption.Supported)]

必选
指示 XML Web services 方法需要事务。由于 Web 服务方法只能作为根对象参与事务,因
此将为 Web 服务方法创建一个新事务。
[WebMethod(TransactionOption= TransactionOption.Required)]

RequiresNew
指示 XML Web services 方法需要新事务。当处理请求时,将在新事务内创建 XML Web services。
[WebMethod(TransactionOption= TransactionOption.RequiresNew)]


eg:

<%@ WebService Language="C#" Class="Bank"%>
<%@ assembly name="System.EntERPriseServices" %>

using System;
using System.Web.Services;
using System.EnterpriseServices;

public class Bank : WebService {

[ WebMethod(TransactionOption=TransactionOption.RequiresNew) ]
public void Transfer(long Amount, long AcctNumberTo, long AcctNumberFrom) {
MyCOMObject objBank = new MyCOMObject();

if (objBank.GetBalance(AcctNumberFrom) < Amount )
// Explicitly abort the transaction.
ContextUtil.SetAbort();
else {
// Credit and Debit methods explictly vote within
// the code for their methods whether to commit or
// abort the transaction.
objBank.Credit(Amount, AcctNumberTo);
objBank.Debit(Amount, AcctNumberFrom);
}
}
}

5)CacheDuration:
Web支持输出高速缓存,这样webservice就不需要执行多遍,可以提高访问效率,
而CacheDuration就是指定缓存时间的属性。


eg:
public static int i=0;
[WebMethod(EnableSession=true,CacheDuration=30)]  //如果调用该函数,则需要30秒才可以刷新。
public int Count()
{
i=i+1;
return i;
}

6)BufferResponse


配置WebService方法是否等到响应被完全缓冲完,才发送信息给请求端。普通应用要等完
 全被缓冲完才被发送的!

eg:



[WebMethod(BufferResponse=false)]
public void HelloWorld1()
{
int i=0;
string s="";
while(i<100)
{
s=s+"i<br>";
this.Context.Response.Write(s);
i++;
}
return;
}


[WebMethod(BufferResponse=true)]
public void HelloWorld2()
{
int i=0;
string s="";
while(i<100)
{
s=s+"i<br>";
this.Context.Response.Write(s);
i++;
}
return;
}

第一种有什么数据马上返回,而后一种是把信息一起返回给请求端的。


————————————————————
技术日志 | 阅读 4068 次
文章评论,共0条
游客请输入验证码