SoapRpcMethodAttribute.OneWay Vlastnost

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Získá nebo nastaví, zda klient webové služby XML čeká na dokončení zpracování metody webové služby XML.

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

Hodnota vlastnosti

Boolean

truepokud klient webové služby XML nečeká, až webový server zcela zpracuje metodu webové služby XML; v opačném případě . false Výchozí hodnota je false.

Příklady

Následující příklad kódu nastaví OneWay vlastnost na 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

Poznámky

Pokud má metoda webové služby XML nastavena OneWaytruevlastnost , klient webové služby XML nemusí čekat na dokončení zpracování metody webové služby XML. Jakmile webový server deserializoval SoapServerMessage, ale předtím, než vyvolá metodu webové služby XML, server vrátí stavový kód HTTP 202. Stavový kód HTTP 202 indikuje klientovi, že webový server spustil zpracování zprávy. Klient webové služby XML proto neobdrží žádné potvrzení, že webový server zprávu úspěšně zpracoval.

Jednosměrné metody nemohou mít návratovou hodnotu ani žádné out parametry.

Pokud používáte metody webové služby .NET Framework verze 1.0 XML, které mají SoapRpcMethodAttributeSoapDocumentMethodAttribute buď nebo atribut použitý u nich s vlastností nastavenou OneWay na true, nepovolujte přístup k jejich HttpContext použití statické Current vlastnosti. Pro přístup HttpContextk , odvození třídy implementace XML webové služby metoda z WebService a přístup k Context vlastnosti.