SoapDocumentMethodAttribute.OneWay-Eigenschaft

Artikel
08/20/2007

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 SoapDocumentMethodAttribute
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. 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, kann mit der statischen Current-Eigenschaft nicht 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

Das folgende Codebeispiel ist eine XML-Webdienstmethode, bei der es nicht erforderlich ist, dass der Client auf das Abschließen der XML-Webdienstmethode wartet. Daher wird im Beispiel 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
        
    <SoapDocumentMethod(OneWay := True), _
    WebMethod(Description := "Starts nightly statistics batch process.")> _
    Public Sub _
        StartStatsCrunch()
        
        ' Begin nightly statistics crunching process.
        ' A one-way method cannot have return values.
    End Sub
End Class

<%@ WebService Language="C#" Class="Stats" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class Stats: WebService {
 
      [ SoapDocumentMethod(OneWay=true) ]
      [ WebMethod(Description="Starts nightly statistics batch process.") ]
      public void StartStatsCrunch() {
         // Begin nightly statistics crunching process.
         // A one-way method cannot have return values.
      }      
 
 }

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

SoapDocumentMethodAttribute-Klasse
SoapDocumentMethodAttribute-Member
System.Web.Services.Protocols-Namespace
SoapServerMessage

Freigeben über