SoapDocumentMethodAttribute.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. 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 attende 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 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 indiquant que le serveur Web a correctement traité le message.

Les méthodes unidirectionnel ne peuvent pas avoir de valeur de retour ni de paramètres sortants.

Si vous utilisez les méthodes de service Web XML .NET Framework version 1.0 auxquelles l’attribut SoapRpcMethodAttribute ou est SoapDocumentMethodAttribute appliqué avec la OneWay propriété définie sur true, n’avez pas accès à leur HttpContext à l’aide de la propriété statique Current . 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é .

Voir aussi

• SoapServerMessage