SoapDocumentMethodAttribute.Action Eigenschap

Definitie

Naamruimte:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Hiermee haalt u het SOAPAction HTTP-headerveld van de SOAP-aanvraag op of stelt u deze in.

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

Waarde van eigenschap

String

Het SOAPAction VELD HTTP-header van de SOAP-aanvraag. De standaardwaarde is http://tempuri.org/MethodName, waarbij MethodName de naam is van de XML-webservicemethode.

Voorbeelden

In het volgende codevoorbeeld wordt de Action eigenschap ingesteld op 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

Opmerkingen

Normaal gesproken is de Action eigenschap een URI die de intentie van de aanvraag aangeeft. De SOAP-specificatie plaatst echter geen beperkingen voor de indeling van de URI of regels over of de URI kan worden omgezet. De aanwezigheid en inhoud van de Action eigenschap kunnen worden gebruikt door webservers, zoals firewalls, om SOAP-aanvraagberichten op de juiste wijze te filteren in HTTP.

Standaard publiceert de .NET Framework-versie 1.1 de eigenschap Action in het kenmerk soapAction van het element soap:operation voor elke ondersteunde SOAP-binding in WSDL-documenten die zijn gegenereerd voor een XML-webservice. Zie de SOAP-specificatie op de W3C-website voor meer informatie.