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;
}
点刷新看看
......
<?xml version="1.0" encoding="utf-8" ?>
<int xmlns="/">19</int>
<?xml version="1.0" encoding="utf-8" ?>
<int xmlns="/">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 ⾥的解释：
webservice用户名密码调用 由于 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的地址栏⾥输⼊：
刷新它，⼀样吧！要使输出不⼀样，等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) {
ader = 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;
}
}
}
MSDN实例
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论