SoapDocumentMethodAttribute.Action Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta il campo di intestazione HTTP SOAPAction della richiesta 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

Valore della proprietà

String

Campo di intestazione HTTP SOAPAction della richiesta SOAP. Il valore predefinito è , dove MethodName è http://tempuri.org/MethodNameil nome del metodo del servizio Web XML.

Esempio

Nell'esempio di codice seguente la Action proprietà viene impostata su 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

Commenti

In genere, la Action proprietà è un URI che indica la finalità della richiesta. Tuttavia, la specifica SOAP non impone alcuna restrizione sul formato dell'URI o sulle regole relative al fatto che l'URI sia risolvibile. La presenza e il Action contenuto della proprietà possono essere usati dai server Web, ad esempio firewall, per filtrare in modo appropriato i messaggi di richiesta SOAP in HTTP.

Per impostazione predefinita, .NET Framework versione 1.1 pubblica la Action proprietà nell'attributo soapAction dell'elemento soap:operation per ogni associazione SOAP supportata nei documenti WSDL generati per un servizio Web XML. Per altre informazioni, vedere la specifica SOAP nel sito Web W3C.