SoapRpcMethodAttribute.OneWay Eigenschaft

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ruft ab oder legt fest, ob ein XML-Webdienstclient wartet, bis der Webserver die Verarbeitung einer XML-Webdienstmethode abgeschlossen hat.

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

Eigenschaftswert

Boolean

truewenn der XML-Webdienstclient nicht darauf wartet, dass der Webserver eine XML-Webdienstmethode vollständig verarbeitet; andernfalls . false Der Standardwert lautet false.

Beispiele

Im folgenden Codebeispiel wird die OneWay Eigenschaft auf 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

Hinweise

Wenn eine XML-Webdienstmethode den OneWay Eigenschaftensatz aufweist true, muss der XML-Webdienstclient nicht warten, bis der Webserver die Verarbeitung der XML-Webdienstmethode abgeschlossen hat. Sobald der Webserver die Deserialisierung deserialisiert SoapServerMessagehat, aber bevor er die XML-Webdienstmethode aufruft, gibt der Server einen HTTP 202-Statuscode zurück. Ein HTTP 202-Statuscode gibt dem Client an, dass der Webserver mit der Verarbeitung der Nachricht begonnen hat. Daher erhält ein XML-Webdienstclient keine Bestätigung, dass der Webserver die Nachricht erfolgreich verarbeitet hat.

Unidirektionale Methoden können keinen Rückgabewert oder Parameter out aufweisen.

Wenn Sie die .NET Framework-Version 1.0-XML-Webdienstmethoden verwenden, auf die entweder die oder das SoapRpcMethodAttributeSoapDocumentMethodAttribute Attribut angewendet wurde, auf die die OneWay Eigenschaft festgelegt ist true, dürfen Sie keinen Zugriff auf die HttpContext verwendung der statischen Current Eigenschaft zulassen. Um auf die HttpContextKlasse zuzugreifen, die die XML-Webdienstmethode WebService implementiert, und greifen Sie auf die Context Eigenschaft zu.