System.Web.Services 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Attribute System.AttributeUsage(System.AttributeTargets.Method, Inherited=true)

Methods within a class that have this attribute set are called XML Web service methods. The method and class must be public and running inside an ASP.NET Web application.

Adding this attribute to a method within an XML Web service created using ASP.NET makes the method callable from remote Web clients. This class cannot be inherited.

- Constructor
  To be added

  Initializes a new instance of the class.

  1.0.5000.0
  2.0.0.0
- Constructor
  To be added

  Initializes a new instance of the class.

  Initializes whether session state is enabled for the XML Web service method.
  1.0.5000.0
  2.0.0.0
- Constructor

  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)]

  Initializes a new instance of the class.

  Initializes whether session state is enabled for the XML Web service method.
  Initializes the transaction support of an XML Web service method.
  1.0.5000.0
  2.0.0.0
- Constructor

  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)]

  Initializes a new instance of the class.

  Initializes whether session state is enabled for the XML Web service method.
  Initializes the transaction support of an XML Web service method.
  Initializes the number of seconds the response is cached.
  1.0.5000.0
  2.0.0.0
- Constructor

  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)]

  Initializes a new instance of the class.

  Initializes whether session state is enabled for the XML Web service method.
  Initializes the transaction support of an XML Web service method.
  Initializes the number of seconds the response is cached.
  Initializes whether the response for this request is buffered.
  1.0.5000.0
  2.0.0.0
- Property
  System.Boolean To be added: an object of type 'bool'

  Setting to true, serializes the response of the XML Web service method into a memory buffer until either the response is completely serialized or the buffer is full. Once the response is buffered, it is returned to the XML Web service client over the network. When is false, the response to the XML Web service method is sent back to the client as it is serialized. In general, you only want to set to false, if it is known that an XML Web service method returns large amounts of data to the client. For smaller amounts of data, XML Web service performance is better with to true.

  When is false, SOAP extensions are disabled for the XML Web service method.

  Gets or sets whether the response for this request is buffered.

  1.0.5000.0
  2.0.0.0
- Property
  System.Int32 To be added: an object of type 'int'

  When caching is enabled requests and responses are held in memory on the server for at least the cache duration so caution must be used if you expect requests or responses to be very large or you expect requests to vary widely.

  There are two issues that can affect output caching in an ASP.NET 2.0 Web service application.

  In ASP.NET 2.0 the HTTP method of the test page has changed from GET to POST. However, POSTs are not normally cached. If you change the test page in an ASP.NET 2.0 Web service application to use GET, caching works properly.

  In addition, HTTP indicates that a user agent (the browser or calling application) should be able to override server caching by setting the "Cache-Control" to "no-cache". ASP.NET applications, therefore, ignore cached results when they find a "no-cache" header.

  Gets or sets the number of seconds the response should be held in the cache.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  The descriptive message is displayed to prospective consumers of the XML Web service when description documents for the XML Web service are generated, such as the Service Description and the Service help page.

  A descriptive message describing the XML Web service method.

  1.0.5000.0
  2.0.0.0
- Property
  System.Boolean To be added: an object of type 'bool'

  In order to store session state in the ASP.NET object, the XML Web service must inherit from and a applied to the XML Web service method, setting the property to true. If session state is not needed for an XML Web service method, then disabling it may improve performance.

  An XML Web service client is uniquely identified by an HTTP cookie returned by an XML Web service. In order for an XML Web service to maintain session state for a client, the client must persist the cookie. Clients can receive the HTTP cookie by creating a new instance of and assigning that to the property of the proxy class before calling the XML Web service method. If you need to maintain session state beyond when the proxy class instance goes out of scope, the client must persist the HTTP cookie between calls to the XML Web service. For instance, a Web Forms client can persist the HTTP cookie by saving the in its own session state. Because not all XML Web services use session state and thus clients are not always required to use the property of a client proxy, the documentation for the XML Web service should state whether session state is used.

  Indicates whether session state is enabled for an XML Web service method.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  The property can be used to alias method or property names. The most common use of the property will be to uniquely identify polymorphic methods. By default, is set to the name of the XML Web service method. Therefore, if an XML Web service contains two or more XML Web service methods with the same name, you can uniquely identify the individual XML Web service methods by setting the to a name unique within the XML Web service, without changing the name of the actual method name in code.

  When data is passed to an XML Web service it is sent in a request and when it is returned it is sent in a response. Within the request and response, the name used for the XML Web service method is its property.

  The message name associated with an XML Web service method must be unique within the XML Web service.

  If a new XML Web serivce method with the same name but different parameters is added after clients are calling the original method, a different message name should be specified for the new method but the original message name should be left as is to ensure compatability with existing clients.

  The name used for the XML Web service method in the data passed to and returned from an XML Web service method.

  1.0.5000.0
  2.0.0.0
- Property
  System.EnterpriseServices.TransactionOption a

  XML Web service methods can only participate as the root object in a transaction, due to the stateless nature of the HTTP protocol. XML Web service methods can invoke COM objects that participate in the same transaction as the XML Web service method, if the COM object is marked to run within a transaction in the Component Services administrative tool. If an XML Web service method with a property of Required or RequiresNew invokes another XML Web service method with a property of Required or RequiresNew, each XML Web service method participates in its own transaction, because an XML Web service method can only act as the root object in a transaction.

  Item

  Description

  Disabled

  Indicates that the XML Web service method does not run within the scope of a transaction. When a request is processed, the XML Web service method is executed without a transaction.

  [WebMethod(TransactionOption= TransactionOption.Disabled)]

  NotSupported

  Indicates that the XML Web service method does not run within the scope of a transaction. When a request is processed, the XML Web service method is executed without a transaction.

  [WebMethod(TransactionOption= TransactionOption.NotSupported)]

  Supported

  Indicates that the XML Web service method does not run within the scope of transactions. When a request is processed, the XML Web service is created without a transaction.

  [WebMethod(TransactionOption= TransactionOption.Supported)]

  Required

  Indicates that the XML Web service method requires a transaction. Since XML Web service methods can only participate as the root object in a transaction, a new transaction will be created for the XML Web service method.

  [WebMethod(TransactionOption= TransactionOption.Required)]

  RequiresNew

  Indicates that the XML Web service method requires a new transaction. When a request is processed, the XML Web service is created within a new transaction.

  [WebMethod(TransactionOption= TransactionOption.RequiresNew)]

  If an exception is thrown from or not caught by an XML Web service method, the transaction is automatically aborted. If no exceptions occur the transaction is automatically committed unless the method explicitly calls SetAbort.

  Indicates the transaction support of an XML Web service method.

  1.0.5000.0
  2.0.0.0