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í formát 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 nastavenou OneWay truevlastnost , 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 označuje klientovi, že webový server spustil zpracování zprávy. Klient webové služby XML proto neobdrží 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 XML verze .NET Framework verze 1.0, které mají SoapRpcMethodAttribute buď použitý atribut, nebo SoapDocumentMethodAttribute atribut u nich s nastavenou trueOneWay vlastností , nepovolujte přístup k jejich HttpContext použití statické Current vlastnosti. Chcete-li získat přístup k HttpContext, odvodit třídu implementuje metodu webové služby XML z WebService a přístup k Context vlastnosti.