MessageDescription.Action Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.0.0

Origine:

MessageDescription.cs

Ottiene o imposta il parametro dell'azione del messaggio SOAP che identifica lo scopo del messaggio.

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

public string Action { get; }

member this.Action : string

Public ReadOnly Property Action As String

Valore della proprietà

String

Un oggetto String che contiene l'URI dell'azione.

Commenti

Questo parametro facoltativo può essere utilizzato per specificare l'URI che identifica lo scopo del messaggio. In SOAP 1.2, ha lo stesso scopo che aveva il campo dell'intestazione HTTP SOAPAction in SOAP 1.1.

Il valore del parametro dell'azione è un riferimento assoluto dell'URI come definito da RFC 2396. La specifica di SOAP 1.2 non richiede che URI sia risolvibile. È necessario che l'URI sia globalmente univoco e stabile nel tempo.

I server, ad esempio i firewall, possono utilizzare la presenza e il contenuto del parametro dell'azione per filtrare messaggi SOAP e facilitare la distribuzione di messaggi SOAP ai gestori di messaggi interni. Non deve essere utilizzato come modalità di autorizzazione all'accesso non protetta.

L'utilizzo del parametro dell'azione è facoltativo. I ricevitori SOAP possono utilizzarlo come suggerimento per ottimizzare l'elaborazione, ma la sua presenza non deve essere necessaria al funzionamento.