SoapActorAttribute Class

  • Article

Indicates the recipient of a SOAP header element. This class cannot be inherited.

Namespace: Microsoft.Web.Services3.Messaging
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim soapActorAttribute1 As New SoapActorAttribute()

Syntax

'Declaration
NotInheritable Public Class SoapActorAttribute
    Inherits Attribute

public sealed class SoapActorAttribute : Attribute

public ref class SoapActorAttribute sealed : Attribute

public final class SoapActorAttribute extends Attribute

public class SoapActorAttribute extends Attribute

Remarks

Apply the SoapActorAttribute attribute to a class that implements a Web service to specify the SOAP actor of the Web service, which is by default the URI that the Web service is listening on. When WSE receives a SOAP message, it verifies that the value of the <wsa:To> SOAP header matches the SOAP actor. To disable this check, set the Actor property to *.

When a Web service is hosted in a Web farm that uses one URI for the load balancer and a different URI for the individual computers in the Web farm, disabling this check is necessary. For example, when SSL is used to access a Web farm, the URI to access the hardware load balancer typically uses the https scheme, whereas the URIs for the individual members of the Web farm use a URI with an http scheme. In this scenario, apply a SoapActorAttribute attribute to the class implementing the Web service and set the Actor property to *.

The SoapActorAttribute can be applied to a class that is hosted by ASP.NET (ASMX) or a class that derives from SoapService.

Inheritance Hierarchy

System.Object
   System.Attribute
    Microsoft.Web.Services3.Messaging.SoapActorAttribute

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

SoapActorAttribute Members
Microsoft.Web.Services3.Messaging Namespace