SoapRpcMethodAttribute.Action Propriedade

Definição

Obtém ou define o campo de cabeçalho HTTP SOAPAction da solicitação SOAP.Gets or sets the SOAPAction HTTP header field of the SOAP request.

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.The SOAPAction HTTP header field of the SOAP request. O padrão é http://tempuri.org/MethodName onde MethodName é o nome do método de serviço Web XML.The default is http://tempuri.org/MethodName where MethodName is the name of the XML Web service method.

Exemplos

O exemplo de código a seguir define a Action propriedade como http://www.contoso.com/Sample .The following code example sets the Action property to http://www.contoso.com/Sample.

<%@ WebService Language="C#" class="MyUser" %>
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class MyUser : WebService {
 
       [ SoapRpcMethod(Action="http://www.contoso.com/Sample", 
           RequestNamespace="http://www.contoso.com/Request",
           RequestElementName="GetUserNameRequest",
           ResponseNamespace="http://www.contoso.com/Response",
           ResponseElementName="GetUserNameResponse")]
      [ WebMethod(Description="Obtains the User Name") ]
      public UserName GetUserName() {
           string temp;
           int pos;
           UserName NewUser = new UserName();
           
           // Get the full user name, including the domain name if applicable.
           temp = User.Identity.Name;
 
           // Determine whether the user is part of a domain by searching for a backslash.
           pos = temp.IndexOf("\\");
           
           // Parse the domain name out of the string, if one exists.
           if (pos <= 0)
                 NewUser.Name = User.Identity.Name;
           else {
               NewUser.Name = temp.Remove(0,pos+1);
                 NewUser.Domain = temp.Remove(pos,temp.Length-pos);
           } 
       return NewUser;
      }
 
 }   
 
 public class UserName {
 
     public string Name;
     public string Domain;
 }
<%@ WebService Language="VB" class="MyUser" %>
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class MyUser
    Inherits WebService    
    
    <SoapRpcMethod(Action := "http://www.contoso.com/Sample", _
    RequestNamespace := "http://www.contoso.com/Request", _
    RequestElementName := "GetUserNameRequest", _
    ResponseNamespace := "http://www.contoso.com/Response", _
    ResponseElementName := "GetUserNameResponse"), _
    WebMethod(Description := "Obtains the User Name")> _
    Public Function _
        GetUserName() As UserName
        
        Dim temp As String
        Dim pos As Integer
        Dim NewUser As New UserName()
        
        ' Get the full user name, including the domain name if applicable.
        temp = User.Identity.Name
        
        ' Determine whether the user is part of a domain by searching for a backslash.
        pos = temp.IndexOf("\")
        
        ' Parse the domain name out of the string, if one exists.
        If pos <= 0 Then
            NewUser.Name = User.Identity.Name
        Else
            NewUser.Name = temp.Remove(0, pos + 1)
            NewUser.Domain = temp.Remove(pos, temp.Length - pos)
        End If
        Return NewUser
    End Function
End Class 

Public Class UserName
    
    Public Name As String
    Public Domain As String
End Class

Comentários

Normalmente, a Action propriedade é um URI que indica a intenção da solicitação SOAP.Typically, the Action property is a URI indicating the intent of the SOAP request. No entanto, a especificação SOAP não impõe restrições no formato e se o URI se refere a um documento existente.However, the SOAP specification places no restrictions on the format and whether the URI refers to an existing document. A presença e o conteúdo da Action propriedade podem ser usados por servidores Web, como firewalls, para filtrar adequadamente as mensagens de solicitação SOAP em http.The presence and content of the Action property can be used by Web servers such as firewalls to appropriately filter SOAP request messages in HTTP.

Por padrão, a .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.By default, the .NET Framework version 1.1 publishes the Action property in the soapAction attribute of the soap:operation element for each supported SOAP binding in WSDL documents generated for an XML Web service. A ligação SOAP com suporte é SOAP 1,1.The supported SOAP binding is SOAP 1.1.

Para obter mais informações, consulte a especificação SOAP no site do W3C.For more information, see the SOAP specification on the W3C website.

Aplica-se a