SoapDocumentMethodAttribute.OneWay Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit si un client de 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 de service web XML n’attend pas que le serveur Web traite complètement une méthode de service Web XML. La valeur par défaut est false.

Exemples

L’exemple de code suivant est une méthode de service Web XML qui ne nécessite pas que le client attend la fin de la méthode de service Web XML. Par conséquent, l’exemple 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 {
 
      [ SoapDocumentMethod(OneWay=true) ]
      [ WebMethod(Description="Starts nightly statistics batch process.") ]
      public void StartStatsCrunch() {
         // Begin nightly statistics crunching process.
         // A one-way method cannot have return values.
      }      
 
 }

<%@ WebService Language="VB" Class="Stats" %>
 
Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class Stats
    Inherits WebService
        
    <SoapDocumentMethod(OneWay := True), _
    WebMethod(Description := "Starts nightly statistics batch process.")> _
    Public Sub _
        StartStatsCrunch()
        
        ' Begin nightly statistics crunching process.
        ' A one-way method cannot have return values.
    End Sub
End Class

Remarques

Lorsqu’une méthode de service Web XML a la OneWay propriété définie truesur , 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é le SoapServerMessage, mais 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 unidirectionnels ne peuvent pas avoir de valeur de retour ou de paramètres sortants.

Si vous utilisez les méthodes de service web XML .NET Framework version 1.0 qui ont l’attribut ou l’attribut SoapRpcMethodAttribute appliqués à ces méthodes avec la OneWay propriété définie truesur , n’avez pas accès à leur HttpContext utilisation à l’aide de la propriété statiqueCurrent.SoapDocumentMethodAttribute Pour accéder à la HttpContextclasse , dérivez la classe implémentant la méthode de service Web XML à partir de WebService la propriété et accédez à la Context propriété.

Voir aussi

• SoapServerMessage