MessageDescription.Action Eigenschaft

Definition

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Quelle:

MessageDescription.cs

Ruft den Aktionsparameter der SOAP-Nachricht ab, der die Absicht der Nachricht identifiziert, oder legt diesen fest.

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

public string Action { get; }

member this.Action : string

Public ReadOnly Property Action As String

Eigenschaftswert

String

Ein String, der die Aktions-URI enthält.

Hinweise

Dieser optionale Parameter kann verwendet werden, um die URI anzugeben, die die Absicht der Nachricht identifiziert. In SOAP 1.2 hat er einen ähnlichen Zweck wie das SOAPAction-HTTP-Headerfeld in SOAP 1.1.

Der Wert des Aktionsparameters ist ein absoluter URI-Verweis, wie von RFC 2396 definiert. Die SOAP 1.2-Spezifikation erfordert nicht, dass der URI lösbar ist. Der URI sollte global eindeutig und stabil sein.

Server, wie Firewalls, können den Aktionsparameter zum Filtern von SOAP-Nachrichten und Vereinfachen der Verteilung von SOAP-Nachrichten an interne Nachrichtenhandler verwenden. Er sollte nicht als eine unsichere Form der Zugriffsautorisierung verwendet werden.

Die Verwendung des Aktionsparameters ist optional. SOAP-Empfänger können ihn zur Optimierung der Verarbeitung einsetzen, er ist jedoch nicht erforderlich.