WebMethodAttribute Constructor (Boolean, TransactionOption)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the WebMethodAttribute class.

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

Public Sub New (
	enableSession As Boolean,
	transactionOption As TransactionOption
)

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.

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: