SoapRpcMethodAttribute.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 di un metodo di servizio Web XML da parte del server; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio di codice seguente la OneWay proprietà viene impostata su 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

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 qualsiasi out parametro.

Se si usano i metodi del servizio Web XML versione 1.0 di .NET Framework che hanno l'attributo o SoapDocumentMethodAttribute applicato a tali metodi con la SoapRpcMethodAttribute proprietà impostata su true, non consentono l'accesso alla HttpContext proprietà usando la OneWay proprietà staticaCurrent. Per accedere a HttpContext, derivare la classe che implementa il metodo del servizio Web XML da WebService e accedere alla Context proprietà.