WebMethodAttribute Constructor (Boolean, TransactionOption, Int32)

 

Initializes a new instance of the WebMethodAttribute class.

Namespace:   System.Web.Services
Assembly:  System.Web.Services (in System.Web.Services.dll)

new : 
        enableSession:bool *
        transactionOption:TransactionOption *
        cacheDuration:int -> WebMethodAttribute

Parameters

enableSession
Type: System.Boolean

Initializes whether session state is enabled for the XML Web service method.

transactionOption
Type: System.EnterpriseServices.TransactionOption

Initializes the transaction support of an XML Web service method.

cacheDuration
Type: System.Int32

Initializes the number of seconds the response is cached.

A web service call can only be the root of a transaction, due to the stateless nature of the HTTP protocol. This means that the following two settings are equivalent, with each call creating a new transaction:

[WebMethod(TransactionOption = TransactionOption.Required)]
[WebMethod(TransactionOption = TransactionOption.RequiresNew)]

It also means that all the following settings are equivalent; meaning no transaction support:

[WebMethod] // TransactionOption.Disabled is the default
[WebMethod(TransactionOption = TransactionOption.Disabled)]
[WebMethod(TransactionOption = Transaction.NotSupported)]
[WebMethod(TransactionOption = Transaction.Supported)]

.NET Framework
Available since 1.1
Return to top
Show: