SoapRpcMethodAttribute.OneWay Eigenschap

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

Waarde van eigenschap

true als de XML-webserviceclient niet wacht totdat de webserver een XML-webservicemethode volledig verwerkt; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende codevoorbeeld wordt de OneWay eigenschap ingesteld op true.

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

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 parameters out 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, sta geen toegang toe 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.