SoapDocumentMethodAttribute.OneWay Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u op of stelt u in of een XML-webserviceclient wacht totdat de webserver klaar is met het verwerken van een XML-webservicemethode.
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 BooleanWaarde van eigenschap
true als de XML-webserviceclient niet wacht totdat de webserver een XML-webservicemethode volledig verwerkt. De standaardwaarde is false.
Voorbeelden
Het volgende codevoorbeeld is een XML-webservicemethode waarvoor de client niet hoeft te wachten totdat de XML-webservicemethode is voltooid. Daarom stelt het voorbeeld de OneWay eigenschap in op true.
<%@ 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.
}
}
<%@ 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
Opmerkingen
Wanneer voor een XML-webservicemethode de OneWay eigenschap is ingesteld true, hoeft de XML-webserviceclient niet te wachten totdat de webserver klaar is met het verwerken van de XML-webservicemethode. Zodra de webserver deserialiseerde, SoapServerMessagemaar voordat de XML-webservicemethode wordt aangeroepen, retourneert de server een HTTP 202-statuscode. Een HTTP 202-statuscode geeft aan de client aan dat de webserver het bericht heeft verwerkt. Daarom ontvangt een XML-webserviceclient geen bevestiging dat de webserver het bericht heeft verwerkt.
Methoden in één richting kunnen geen retourwaarde of eventuele outparameters hebben.
Als u gebruikmaakt van de .NET Framework versie 1.0 XML-webservicemethoden waarop de eigenschap SoapRpcMethodAttribute of SoapDocumentMethodAttribute is toegepast met de eigenschap OneWay ingesteld op true, hebt u geen toegang tot hun HttpContext met behulp van de eigenschap static Current. Als u toegang wilt krijgen tot de HttpContextklasse, leidt u de klasse af die de XML-webservicemethode implementeert van WebService en opent u de Context eigenschap.