SoapDocumentMethodAttribute.Action Vlastnost

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Získá nebo nastaví pole hlavičky SOAPAction HTTP požadavku 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

Hodnota vlastnosti

String

Pole SOAPAction hlavičky HTTP požadavku SOAP. Výchozí hodnota je http://tempuri.org/MethodName, kde MethodName je název metody webové služby XML.

Příklady

Následující příklad kódu nastaví Action vlastnost na 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

Poznámky

Vlastnost je obvykle identifikátor URI označující Action záměr požadavku. Specifikace SOAP však neukládá žádná omezení formátu identifikátoru URI ani žádná pravidla týkající se toho, zda je identifikátor URI přeložitelný. Přítomnost a obsah Action vlastnosti mohou webové servery, jako jsou brány firewall, použít k odpovídajícímu filtrování zpráv požadavků PROTOKOLU SOAP v protokolu HTTP.

Ve výchozím nastavení rozhraní .NET Framework verze 1.1 publikuje Action vlastnost v atributu soapActionsoap:operation elementu pro každou podporovanou vazbu SOAP v dokumentech WSDL vygenerovaných pro webovou službu XML. Další informace najdete ve specifikaci SOAP na webu W3C.