SoapDocumentMethodAttribute.Action Tulajdonság

Definíció

Névtér:

System.Web.Services.Protocols

Szerelvény:

System.Web.Services.dll

Lekéri vagy beállítja a SOAPAction SOAP-kérelem HTTP-fejléc mezőjét.

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

Tulajdonság értéke

String

A SOAPAction SOAP-kérelem HTTP-fejlécmezője. Az alapértelmezett érték az http://tempuri.org/MethodName, ahol a MethodName az XML webszolgáltatás metódusának neve.

Példák

Az alábbi példakód a tulajdonságot a Action következőre http://www.contoso.com/GetUserNameállítja: .

<%@ 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

Megjegyzések

A tulajdonság általában egy URI, Action amely a kérés szándékát jelzi. A SOAP-specifikáció azonban nem korlátozza az URI formátumát, sem az URI feloldhatóságára vonatkozó szabályokat. A tulajdonság jelenlétét és tartalmát webkiszolgálók Action , például tűzfalak használhatják a SOAP-kérésüzenetek HTTP-ben való megfelelő szűréséhez.

Alapértelmezés szerint az .NET Framework 1.1-es verziója közzéteszi a Action tulajdonságot az XML-webszolgáltatáshoz létrehozott WSDL-dokumentumokban a soapAction elem soap:operation attribútumában. További információkért tekintse meg a SOAP specifikációját a W3C webhelyén.