WebService 之 属性详解

　　WebService 主要包含 WebService 、SoapDocumentService、WebServiceBinding三个属性。若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，需取消对下行的注释。
　　// [System.Web.Script.Services.ScriptService]

　　3、WebService 所暴露给调用者的方法带有 [WebMethod] 属性，有6个属性：Description、EnableSession、MessageName、TransactionOption、CacheDuration、BufferResponse。

　　[1] Description: 是对webservice方法描述的信息。就像webservice方法的功能注释，可以让调用者看见的注释。

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

WSDL:

- <portType name="Service1Soap">
- <operation name="HelloWorld">
  <documentation>方法:Hello World</documentation> 
  <input message="s0:HelloWorldSoapIn" /> 
  <output message="s0:HelloWorldSoapOut" /> 
  </operation>
  </portType>
- <portType name="Service1HttpGet">
- <operation name="HelloWorld">
  <documentation>Author:ZFive5 Function:Hello World</documentation> 
  <input message="s0:HelloWorldHttpGetIn" /> 
  <output message="s0:HelloWorldHttpGetOut" /> 
  </operation>
  </portType>
- <portType name="Service1HttpPost">
- <operation name="HelloWorld">
  <documentation>Author:ZFive5 Function:Hello World</documentation> 
  <input message="s0:HelloWorldHttpPostIn" /> 
  <output message="s0:HelloWorldHttpPostOut" /> 
  </operation>
  </portType>

　　[2] EnableSession：指示webservice否启动session标志，主要通过cookie完成的，默认false。

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

　　在ie地址栏输入：
　　http://localhost/WebService1/Service1.asmx/Count?

　　点刷新看看

......
<?xml version="1.0" encoding="utf-8" ?>
  <int xmlns="http://tempuri.org/">19</int>
 
<?xml version="1.0" encoding="utf-8" ?>
  <int xmlns="http://tempuri.org/">20</int>
......

　　通过它实现webservice数据库访问的事物处理，做过实验，可以哦！

　　[3] MessageName：主要实现方法重载后的重命名

　　在下面的示例中，MessageName 用于消除两个 Add 方法的歧义。

using System;
using System.Web.Services;
 
public class Calculator : WebService {
    // The MessageName property defaults to Add for this XML Web service method.
    [WebMethod]
    public int Add(int i, int j) {
       return i + j;
    }   
    [WebMethod(MessageName="Add2")]
    public int Add(int i, int j, int k) {
       return i + j + k;
    }   
 }

　　通过Add访问的是第一个方法，而通过Add2访问的是第二个方法！

　　[4] TransactionOption：指示 XML Web services 方法的事务支持。

　　以下是 msdn 里的解释：

　　由于 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)]
 
Supported （msdn里写错了，这里改正）

如果有事务，指示 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)]
 
这里我没有实践过，所以只能抄袭msdn，这里请包涵一下了

C#
<%@ 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就是指定缓存时间的属性。我一般定义为12个小时，对于一些不是需要经常取数据的情况。

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

　　在ie的地址栏里输入：

　　http://localhost/WebService1/Service1.asmx/Count?

　　刷新它，一样吧！要使输出不一样，等30秒。。。
　　因为代码30秒后才被再次执行，之前返回的结果都是在服务器高速缓存里的内容。

　　[6] BufferResponse

　　配置WebService方法是否等到响应被完全缓冲完，才发送信息给请求端。普通应用要等完全被缓冲完才被发送的！
　　看看下面的程序：
　　通常情况下，只有当已知 XML Web services 方法将大量数据返回到客户端时，才需要将 BufferResponse 设置为 false。对于少量数据，将 BufferResponse 设置为 true 可提高 XML Web services 的性能。

　　当 BufferResponse 为 false 时，将对 XML Web services 方法禁用 SOAP 扩展名。

[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;
 }

 
从两个方法在ie里执行的结果就可以看出他们的不同，第一种，是推技术哦！

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

我的例子本身破坏了webservice返回结构，所以又拿出msdn里的例子来，不要
怪哦！

<%@WebService class="Streaming" language="C#"%>

using System;
using System.IO;
using System.Collections;
using System.Xml.Serialization;
using System.Web.Services;
using System.Web.Services.Protocols;

public class Streaming {

　　[WebMethod(BufferResponse=false)]
　　public TextFile GetTextFile(string filename) {
　　　　return new TextFile(filename);
　　}

　　[WebMethod]
　　public void CreateTextFile(TextFile contents) {
　　　　contents.Close();
　　}

}

public class TextFile {
　　public string filename;
　　private TextFileReaderWriter readerWriter;

　　public TextFile() {
　　}

　　public TextFile(string filename) {
　　　　this.filename = filename;
　　}

　　[XmlArrayItem("line")]
　　public TextFileReaderWriter contents {
　　　　get {
　　　　　　readerWriter = new TextFileReaderWriter(filename);
　　　　　　return readerWriter;
　　　　}
　　}

　　public void Close() {
　　　　if (readerWriter != null) readerWriter.Close();
　　}
}

public class TextFileReaderWriter : IEnumerable {

　　public string Filename;
　　private StreamWriter writer;

　　public TextFileReaderWriter() {
　　}

　　public TextFileReaderWriter(string filename) {
　　　　Filename = filename;
　　}

　　public TextFileEnumerator GetEnumerator() {
　　　　StreamReader reader = new StreamReader(Filename);
　　　　return new TextFileEnumerator(reader);
　　}

　　IEnumerator IEnumerable.GetEnumerator() {
　　　　return GetEnumerator();
　　}

　　public void Add(string line) {
　　　　if (writer == null)
　　　　　　writer = new StreamWriter(Filename);
　　　　writer.WriteLine(line);
　　}

　　public void Close() {
　　　　if (writer != null) writer.Close();
　　}

}

public class TextFileEnumerator : IEnumerator {
　　private string currentLine;
　　private StreamReader reader;

　　public TextFileEnumerator(StreamReader reader) {
　　　　this.reader = reader;
　　}

　　public bool MoveNext() {
　　　　currentLine = reader.ReadLine();
　　　　if (currentLine == null) {
　　　　　　reader.Close();
　　　　　　return false;
　　　　}
　　　　else
　　　　　　return true;
　　}

　　public void Reset() {
　　　　reader.BaseStream.Position = 0;
　　}

　　public string Current {
　　　　get {
　　　　　　return currentLine;
　　　　}
　　}

　　object IEnumerator.Current {
　　　　get {
　　　　　　return Current;
　　　　}
　　}
}