SoapRpcMethodAttribute.OneWay Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property OneWay As BooleanEigenschaftswert
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.
