SoapRpcMethodAttribute.OneWay Eigenschaft

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ruft ab oder legt fest, ob ein XML-Webdienstclient darauf wartet, dass der Webserver die Verarbeitung einer XML-Webdienstmethode beendet.

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

true, wenn der XML-Webdienstclient nicht darauf wartet, dass der Webserver eine XML-Webdienstmethode vollständig verarbeitet, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird die OneWay -Eigenschaft auf truefestgelegt.

<%@ 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 für eine XML-Webdienstmethode die OneWay Eigenschaft auf truefestgelegt ist, muss der XML-Webdienstclient nicht warten, bis der Webserver die Verarbeitung der XML-Webdienstmethode abgeschlossen hat. Sobald der Webserver das deserialisiert hat, aber bevor er die SoapServerMessageXML-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 aufweisen out .

Wenn Sie die .NET Framework XML-Webdienstmethoden der Version 1.0 verwenden, für die entweder das SoapRpcMethodAttribute Attribut oder SoapDocumentMethodAttribute oder angewendet wird, wobei die OneWay Eigenschaft auf truefestgelegt ist, erlauben Sie keinen Zugriff auf sie HttpContext mithilfe der statischen Current Eigenschaft. Um auf die zuzugreifen HttpContext, leiten Sie die Klasse ab, die die XML-Webdienstmethode implementiert, WebService und greifen Sie auf die Context -Eigenschaft zu.