MessageDescription.Action Propriedade

Definição

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v8.0.0

Origem:

MessageDescription.cs

Obtém ou define o parâmetro de ação da mensagem SOAP que identifica a intenção da mensagem.

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

public string Action { get; }

member this.Action : string

Public ReadOnly Property Action As String

Valor da propriedade

String

Um String que contém o URI da ação.

Comentários

Esse parâmetro opcional pode ser usado para especificar o URI que identifica a intenção da mensagem. No SOAP 1.2, ele serve a uma finalidade semelhante à que o campo de cabeçalho HTTP SOAPAction fez no SOAP 1.1.

O valor do parâmetro action é uma referência de URI absoluta, conforme definido pelo RFC 2396. A especificação SOAP 1.2 não exige que o URI seja resolvível. O URI deve ser globalmente exclusivo e estável ao longo do tempo.

Servidores, como firewalls, podem usar a presença e o conteúdo do parâmetro de ação para filtrar mensagens SOAP e facilitar a expedição de mensagens SOAP para manipuladores de mensagens internas. Ele não deve ser usado como uma forma insegura de autorização de acesso.

O uso do parâmetro action é opcional. Os receptores SOAP podem usá-lo como uma dica para otimizar o processamento, mas não devem exigir sua presença para operar.