SoapDocumentMethodAttribute.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

true Pokud klient webové služby XML nečeká, až webový server zcela zpracuje metodu webové služby XML. Výchozí hodnota je false.

Příklady

Následující příklad kódu je metoda webové služby XML, která nevyžaduje, aby klient čekal na dokončení metody webové služby XML. Proto ukázka nastaví OneWay vlastnost na 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

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řed vyvoláním metody webové služby XML vrátí server 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é výstupní 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 OneWay vlastností nastavenou truena , nemáte 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.

Viz také

• SoapServerMessage