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;
}
}
}
|
编辑器加载中...