SoapRpcMethodAttribute.OneWay Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

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é

Boolean

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 truesur , 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é .