SoapDocumentMethodAttribute.Action Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit le champ d'en-tête HTTP SOAPAction de la demande 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

Valeur de propriété

String

Champ d'en-tête HTTP SOAPAction de la demande SOAP. La valeur par défaut est http://tempuri.org/MethodName, où MethodName est le nom de la méthode de service Web XML.

Exemples

L’exemple de code suivant définit la Action propriété sur 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

Remarques

En règle générale, la Action propriété est un URI indiquant l’intention de la demande. Toutefois, la spécification SOAP n’impose aucune restriction au format de l’URI, ni à aucune règle quant à la résolution de l’URI. La présence et le contenu de la Action propriété peuvent être utilisés par les serveurs web, tels que les pare-feu, pour filtrer de manière appropriée les messages de requête SOAP dans HTTP.

Par défaut, .NET Framework version 1.1 publie la propriété dans l’attribut Action de l’élément soapActionsoap:operation pour chaque liaison SOAP prise en charge dans les documents WSDL générés pour un service Web XML. Pour plus d’informations, consultez la spécification SOAP sur le site web W3C.