SoapDocumentMethodAttribute.OneWay Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta l'eventuale attesa da parte del client di un servizio Web XML per il completamento dell'elaborazione di un metodo di servizio Web XML da parte di un server Web.

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

Valore della proprietà

Boolean

true se il client del servizio Web XML non aspetta il completamento dell'elaborazione del metodo di servizio Web XML da parte del server. Il valore predefinito è false.

Esempio

L'esempio di codice seguente è un metodo di servizio Web XML che non richiede al client di attendere il completamento del metodo del servizio Web XML. Di conseguenza, l'esempio imposta la OneWay proprietà su 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

Commenti

Quando un metodo di servizio Web XML ha la OneWay proprietà impostata su true, il client del servizio Web XML non deve attendere che il server Web finisca l'elaborazione del metodo del servizio Web XML. Non appena il server Web ha deserializzato , SoapServerMessagema prima di richiamare il metodo del servizio Web XML, il server restituisce un codice di stato HTTP 202. Un codice di stato HTTP 202 indica al client che il server Web ha avviato l'elaborazione del messaggio. Pertanto, un client del servizio Web XML non riceve alcun riconoscimento che il server Web ha elaborato correttamente il messaggio.

I metodi unidirezionale non possono avere un valore restituito o parametri out.

Se si usano i metodi del servizio Web XML .NET Framework versione 1.0 che dispongono dell'attributo SoapRpcMethodAttribute o SoapDocumentMethodAttribute applicato a tali metodi con la OneWay proprietà impostata su true, non è possibile accedervi HttpContext usando la proprietà statica Current . Per accedere a HttpContext, derivare la classe che implementa il metodo del servizio Web XML da WebService e accedere alla Context proprietà .

Vedi anche

• SoapServerMessage