SoapRpcMethodAttribute.OneWay 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 si le client du service Web XML attend que le serveur Web termine le traitement d'une méthode de service Web XML.
public:
property bool OneWay { bool get(); void set(bool value); };
public bool OneWay { get; set; }
member this.OneWay : bool with get, set
Public Property OneWay As Boolean
Valeur de propriété
true
si le client du service Web XML n'attend pas que le serveur Web termine le traitement d'une méthode de service Web XML ; sinon, false
. La valeur par défaut est false
.
Exemples
L’exemple de code suivant définit la OneWay propriété sur true
.
<%@ WebService Language="C#" Class="Stats" %>
using System.Web.Services;
using System.Web.Services.Protocols;
public class Stats: WebService {
[ SoapRpcMethod(OneWay=true) ]
[ WebMethod(Description="Starts nightly stats batch process.") ]
public void StartStatsCrunch() {
// Begin a process that takes a long time to complete.
}
}
<%@ WebService Language="VB" Class="Stats" %>
Imports System.Web.Services
Imports System.Web.Services.Protocols
Public Class Stats
Inherits WebService
<SoapRpcMethod(OneWay := True), _
WebMethod(Description := "Starts nightly stats batch process.")> _
Public Sub _
StartStatsCrunch()
' Begin a process that takes a long time to complete.
End Sub
End Class
Remarques
Lorsqu’une méthode de service Web XML a la OneWay propriété définie sur true
, le client de service Web XML n’a pas besoin d’attendre que le serveur Web termine le traitement de la méthode de service Web XML. Dès que le serveur Web a désérialisé , SoapServerMessagemais avant d’appeler la méthode de service Web XML, le serveur retourne un code d’état HTTP 202. Un code d’état HTTP 202 indique au client que le serveur Web a commencé à traiter le message. Par conséquent, un client de service Web XML ne reçoit aucun accusé de réception que le serveur Web a correctement traité le message.
Les méthodes unidirectionnelles ne peuvent pas avoir de valeur de retour ou de out
paramètres.
Si vous utilisez les méthodes de service Web XML .NET Framework version 1.0 qui ont l’attribut ou SoapDocumentMethodAttribute appliqué à celles-ci avec la OneWaySoapRpcMethodAttribute propriété définie true
sur , n’autorisez pas l’accès à leurs HttpContext à l’aide de la propriété statiqueCurrent. Pour accéder à , HttpContextdérivez la classe implémentant la méthode de service Web XML à partir de WebService et accédez à la Context propriété .