MessageDescription.Action Property

Definition

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.0.0

Source:

MessageDescription.cs

Gets or sets the action parameter of the SOAP message that identifies the intent of the message.

public:
 property System::String ^ Action { System::String ^ get(); };

public string Action { get; }

member this.Action : string

Public ReadOnly Property Action As String

Property Value

String

A String that contains the action URI.

Remarks

This optional parameter can be used to specify the URI that identifies the intent of the message. In SOAP 1.2, it serves a similar purpose as the SOAPAction HTTP header field did in SOAP 1.1.

The value of the action parameter is an absolute URI reference as defined by RFC 2396. The SOAP 1.2 specification does not require that the URI be resolvable. The URI should be globally unique and stable over time.

Servers, such as firewalls, can use the presence and content of the action parameter to filter SOAP messages and to facilitate the dispatch of SOAP messages to internal message handlers. It should not be used as an insecure form of access authorization.

Use of the action parameter is optional. SOAP receivers can use it as a hint to optimize processing, but must not require its presence to operate.