SoapDocumentMethodAttribute.OneWay Tulajdonság

Definíció

Névtér:

System.Web.Services.Protocols

Szerelvény:

System.Web.Services.dll

Lekérdezi vagy beállítja, hogy egy XML-webszolgáltatás-ügyfél megvárja-e, amíg a webkiszolgáló befejezi az XML-webszolgáltatás-metódus feldolgozását.

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

Tulajdonság értéke

Boolean

true ha az XML webszolgáltatás-ügyfél nem várja meg, amíg a webkiszolgáló teljesen feldolgoz egy XML-webszolgáltatás-metódust. Az alapértelmezett érték a false.

Példák

A következő példakód egy XML-webszolgáltatás-metódus, amely nem követeli meg, hogy az ügyfél megvárja az XML-webszolgáltatás metódusának befejezését. Ezért a minta a tulajdonságot a OneWay következőre trueállítja: .

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

Megjegyzések

Ha egy XML-webszolgáltatás-metódus tulajdonsága be van OneWay állítva true, az XML-webszolgáltatás-ügyfélnek nem kell megvárnia, amíg a webkiszolgáló befejezi az XML-webszolgáltatás-metódus feldolgozását. Amint a webkiszolgáló deszerializálta az SoapServerMessageXML-webszolgáltatás metódusát, a kiszolgáló egy HTTP 202 állapotkódot ad vissza. A HTTP 202 állapotkód jelzi az ügyfélnek, hogy a webkiszolgáló megkezdte az üzenet feldolgozását. Ezért egy XML-webszolgáltatás-ügyfél nem kap visszaigazolást arról, hogy a webkiszolgáló sikeresen feldolgozta az üzenetet.

Az egyirányú metódusok nem rendelkeznek visszatérési értékkel vagy kimenő paraméterekkel.

Ha az .NET Keretrendszer 1.0-s verziójának XML-webszolgáltatás-metódusait használja, amelyek SoapRpcMethodAttribute vagy SoapDocumentMethodAttribute attribútumot alkalmaznak rájuk a OneWay beállítás true tulajdonságával, nem férnek hozzá a HttpContext statikus Current tulajdonság használatával. A HttpContexthozzáféréshez származtathatja az XML-webszolgáltatás metódusát implementáló osztályt a tulajdonságból WebService , és hozzáférhet a Context tulajdonsághoz.

Lásd még

• SoapServerMessage