SoapDocumentMethodAttribute.Action Propiedad

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Obtiene o establece el campo de encabezado HTTP SOAPAction de la solicitud 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 de propiedad

String

Campo de encabezado HTTP SOAPAction de la solicitud SOAP. El valor predeterminado es http://tempuri.org/MethodName, donde MethodName es el nombre del método de servicio web XML.

Ejemplos

En el ejemplo de código siguiente se establece la Action propiedad http://www.contoso.com/GetUserNameen .

<%@ 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

Comentarios

Normalmente, la Action propiedad es un URI que indica la intención de la solicitud. Sin embargo, la especificación SOAP no aplica ninguna restricción al formato del URI o a las reglas sobre si el URI se puede resolver. Los servidores web pueden usar la presencia y el contenido de la Action propiedad, como los firewalls, para filtrar correctamente los mensajes de solicitud SOAP en HTTP.

De forma predeterminada, el .NET Framework versión 1.1 publica la Action propiedad en el soapAction atributo del soap:operation elemento para cada enlace SOAP admitido en los documentos WSDL generados para un servicio web XML. Para obtener más información, vea la especificación SOAP en el sitio web de W3C.