SoapDocumentMethodAttribute.Action Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 soapAction
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.