SoapDocumentMethodAttribute.Action Propriedade

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtém ou define o campo de cabeçalho HTTP SOAPAction da solicitação SOAP.

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

public string Action { get; set; }

member this.Action : string with get, set

Public Property Action As String

Valor da propriedade

String

O campo de cabeçalho HTTP SOAPAction da solicitação SOAP. O padrão é http://tempuri.org/MethodName, em que MethodName é o nome do método de serviço Web XML.

Exemplos

O exemplo de código a seguir define a Action propriedade como http://www.contoso.com/GetUserName.

<%@ WebService Language="C#" class="MyUser" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class MyUser : WebService {
 
      [ SoapDocumentMethod(Action="http://www.contoso.com/GetUserName")]
      public string GetUserName() {
       return User.Identity.Name;
      }
 }

<%@ WebService Language="VB" class="MyUser" %>

Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class MyUser
    Inherits WebService
        
    <SoapDocumentMethod(Action := "http://www.contoso.com/GetUserName")> _
    Public Function _
        GetUserName() As String
        
        Return User.Identity.Name
    End Function
End Class

Comentários

Normalmente, a Action propriedade é um URI que indica a intenção da solicitação. No entanto, a especificação SOAP não coloca nenhuma restrição no formato do URI ou quaisquer regras sobre se o URI é resolvível. A presença e o Action conteúdo da propriedade podem ser usados por servidores Web, como firewalls, para filtrar adequadamente as mensagens de solicitação SOAP em HTTP.

Por padrão, o .NET Framework versão 1.1 publica a Action propriedade no soapAction atributo do soap:operation elemento para cada associação SOAP com suporte em documentos WSDL gerados para um serviço Web XML. Para obter mais informações, consulte a especificação SOAP no site do W3C.