SoapDocumentMethodAttribute.Action-Eigenschaft

Ruft das SOAPAction-HTTP-Headerfeld der SOAP-Anforderung ab oder legt dieses fest.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property Action As String
'Usage
Dim instance As SoapDocumentMethodAttribute
Dim value As String

value = instance.Action

instance.Action = value

public string Action { get; set; }

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

/** @property */
public String get_Action ()

/** @property */
public void set_Action (String value)

public function get Action () : String

public function set Action (value : String)

Eigenschaftenwert

Das SOAPAction-HTTP-Headerfeld der SOAP-Anforderung. Die Standardeinstellung ist http://tempuri.org/Methodenname, wobei Methodenname der Name der XML-Webdienstmethode ist.

Hinweise

In der Regel ist die Action-Eigenschaft ein URI, der den Zweck der Anforderung angibt. Durch die SOAP-Spezifikation wird jedoch weder das Format des URIs noch die Regeln für das Auflösen des URIs eingeschränkt. Das Vorhandensein und der Inhalt der Action-Eigenschaft kann von Webservern, z. B. Firewalls, genutzt werden, um SOAP-Anforderungsmeldungen in HTTP entsprechend zu filtern.

.NET Framework, Version 1.1, veröffentlicht die Action-Eigenschaft im soapAction-Attribut des soap:operation-Elements für jede unterstützte SOAP-Bindung in für einen XML-Webdienst generierten WSDL-Dokumenten. Weitere Informationen über die SOAP-Spezifikation finden Sie auf der W3C-Website unter http://www.w3.org/TR/SOAP (nur auf Englisch verfügbar).

Beispiel

Im folgenden Codebeispiel wird die Action-Eigenschaft auf https://www.contoso.com/GetUserName festgelegt.

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

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

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapDocumentMethodAttribute-Klasse
SoapDocumentMethodAttribute-Member
System.Web.Services.Protocols-Namespace