SoapRpcMethodAttribute.OneWay Property

Definition

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.Gets or sets whether an XML Web service client waits for the Web server to finish processing an XML Web service method.

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

Property Value

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.true if the XML Web service client does not wait for the Web server to completely process an XML Web service method; otherwise, false. Il valore predefinito è false.The default is false.

Examples

Nell'esempio di codice riportato di seguito viene impostata la proprietà OneWay su true.The following code example sets the OneWay property to 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

Remarks

Quando un metodo di servizio Web XML dispone della proprietà OneWay impostata su true, il client del servizio Web XML non deve attendere il completamento dell'elaborazione del metodo di servizio Web XML da parte del server Web.When an XML Web service method has the OneWay property set to true, the XML Web service client does not have to wait for the Web server to finish processing the XML Web service method. Non appena il server Web ha deserializzato il SoapServerMessage, ma prima di richiamare il metodo del servizio Web XML, il server restituisce un codice di stato HTTP 202.As soon as the Web server has deserialized the SoapServerMessage, but before it invokes the XML Web service method, the server returns an HTTP 202 status code. Un codice di stato HTTP 202 indica al client che il server Web ha avviato l'elaborazione del messaggio.An HTTP 202 status code indicates to the client that the Web server has started processing the message. Pertanto, un client del servizio Web XML non riceve alcuna conferma che il server Web ha elaborato correttamente il messaggio.Therefore, an XML Web service client receives no acknowledgment that the Web server successfully processed the message.

I metodi unidirezionali non possono avere un valore restituito o un parametro di out.One-way methods cannot have a return value or any out parameters.

Se si utilizzano i metodi del servizio Web XML .NET Framework versione 1,0 a cui è applicato l'attributo SoapRpcMethodAttribute o SoapDocumentMethodAttribute con la proprietà OneWay impostata su true, non consentire l'accesso ai HttpContext utilizzando la proprietà Current statica.If you are using the .NET Framework version 1.0 XML Web service methods that have either the SoapRpcMethodAttribute or SoapDocumentMethodAttribute attribute applied to them with the OneWay property set to true, do not allow access to their HttpContext using the static Current property. Per accedere alla HttpContext, derivare la classe che implementa il metodo di servizio Web XML da WebService e accedere alla proprietà Context.To access the HttpContext, derive the class implementing the XML Web service method from WebService and access the Context property.

Applies to