Ler em inglês

Compartilhar via


MessageDescription.Action Propriedade

Definição

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

C#
public string Action { get; }

Valor da propriedade

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.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
UWP 10.0