SoapDocumentMethodAttribute.Action Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit le SOAPAction champ d’en-tête HTTP de la requête 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 SOAPAction d’en-tête HTTP de la requête 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 requête. Toutefois, la spécification SOAP n’impose aucune restriction sur le format de l’URI ou sur les règles relatives à la résolution de l’URI. La présence et le contenu de la Action propriété peuvent être utilisés par des serveurs Web, tels que des pare-feu, pour filtrer correctement les messages de requête SOAP dans HTTP.

Par défaut, .NET Framework version 1.1 publie la propriété dans l’attribut ActionsoapAction de l’élément soap: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.