SoapRpcMethodAttribute.OneWay-Eigenschaft

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

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property OneWay As Boolean
'Usage
Dim instance As SoapRpcMethodAttribute
Dim value As Boolean

value = instance.OneWay

instance.OneWay = value

public bool OneWay { get; set; }

public:
property bool OneWay {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_OneWay ()

/** @property */
public void set_OneWay (boolean value)

public function get OneWay () : boolean

public function set OneWay (value : boolean)

Eigenschaftenwert

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

Hinweise

Wenn die OneWay-Eigenschaft einer XML-Webdienstmethode auf true festgelegt ist, muss der XML-Webdienstclient nicht darauf warten, dass der Webserver die Verarbeitung der XML-Webdienstmethode beendet. Sobald der Webserver die SoapServerMessage deserialisiert hat, aber vor dem Aufrufen der XML-Webdienstmethode, gibt der Server einen HTTP 202-Statuscode zurück. Ein HTTP 202-Statuscode teilt dem Client mit, dass der Webserver mit der Verarbeitung der Meldung begonnen hat. Folglich erhält ein XML-Webdienstclient keine Bestätigung darüber, ob der Webserver die Meldung erfolgreich verarbeitet hat.

Unidirektionalen Methoden können keine Rückgabewerte oder out-Parameter zugewiesen werden.

Wenn Sie XML-Webdienstmethoden von .NET Framework, Version 1.0, verwenden, auf die das SoapRpcMethodAttribute-Attribut oder das SoapDocumentMethodAttribute-Attribut angewendet wird, wobei die OneWay-Eigenschaft auf true festgelegt ist, sollte nicht mit der statischen Current-Eigenschaft auf den HttpContext zugegriffen werden. Leiten Sie für den Zugriff auf HttpContext die Klasse ab, indem Sie die XML-Webdienstmethode aus WebService implementieren, und greifen Sie auf die Context-Eigenschaft zu.

Beispiel

Im folgenden Codebeispiel wird die OneWay-Eigenschaft auf true festgelegt.

<%@ 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

<%@ 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.
      }      
 
 }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapRpcMethodAttribute-Klasse
SoapRpcMethodAttribute-Member
System.Web.Services.Protocols-Namespace