.net 下webservice 的WebMethod的属性

WebMethod有6个属性:
.Description
.EnableSession
.MessageName
.TransactionOption
.CacheDuration
.BufferResponse
 
 
1) Description:
 
是对webservice方法描述的信息。就像webservice方法的功能注释,可以让调用者看见
的注释。
 
C#:
 
[WebMethod(Description="Author:ZFive5 Function:Hello World") ]
public string HelloWorld()
{
  return "Hello World";
}
 
 
WSDL:
 
- <portType name="Service1Soap">
- <operation name="HelloWorld">
  <documentation>Author:ZFive5 Function: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
 
C#:
 
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="19http://tempuri.org/">19</int>
   
<?xml version="1.0" encoding="utf-8" ?>
  <int xmlns="20http://tempuri.org/">20</int>
......
......
 
通过它实现webservice数据库访问的事物处理,做过实验,可以哦!
 
 
3)MessageName:
 
主要实现方法重载后的重命名:
 
C#:
 
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 方法的事务支持。
 
这是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就是指定缓存时间的属性。
 
C#:
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方法是否等到响应被完全缓冲完,才发送信息给请求端。普通应用要等完
全被缓冲完才被发送的!看看下面的程序:
 
C#:
 
[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里的例子来,不要
怪哦!
 
[C#]
<%@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;
    }
  }
}

编辑器加载中...

原文地址:https://www.cnblogs.com/asdyzh/p/9818302.html