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 webový server dokončit 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á na webový server zcela zpracovat 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 OneWay webové služby XML vlastnost nastavena na true, klient webové služby XML nemusí čekat na webový server dokončit zpracování metody webové služby XML. Jakmile webový server deserializuje SoapServerMessage, ale před vyvoláním metody webové služby XML server vrátí stavový kód HTTP 202. Stavový kód HTTP 202 indikuje klientovi, že webový server zahájil zpracování zprávy. Klient webové služby XML proto neobdrží žádné potvrzení, že webový server úspěšně zpracoval zprávu.

Jednosměrné metody nemůžou mít návratovou hodnotu ani odchozí parametry.

Pokud používáte metody webové služby XML rozhraní .NET Framework verze 1.0, které mají SoapRpcMethodAttribute atribut OneWay nebo SoapDocumentMethodAttribute s vlastností nastavenou na true, nemají přístup k jejich HttpContext pomocí statické Current vlastnosti. Chcete-li získat přístup k objektu HttpContext, odvodit třídu implementují metodu webové služby XML z WebService a přistupovat k Context vlastnosti .

Viz také

• SoapServerMessage