SoapRpcMethodAttribute.OneWay Özellik

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

XML Web hizmeti istemcisinin Web sunucusunun XML Web hizmeti yöntemini işlemeyi tamamlayıp bitirmemesini bekleyip beklemediğini alır veya ayarlar.

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

Özellik Değeri

Boolean

true XML Web hizmeti istemcisi Web sunucusunun bir XML Web hizmeti yöntemini tamamen işlemesini beklemiyorsa; aksi takdirde , false. Varsayılan değer: false.

Örnekler

Aşağıdaki kod örneği özelliğini olarak trueayarlarOneWay.

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

Açıklamalar

XML Web hizmeti yönteminde OneWay özelliği olarak ayarlandığında true, XML Web hizmeti istemcisinin Web sunucusunun XML Web hizmeti yöntemini işlemeyi bitirmesini beklemesi gerekmez. Web sunucusu, XML Web hizmeti yöntemini çağırmadan önce serisini SoapServerMessagekaldırdığı anda, sunucu bir HTTP 202 durum kodu döndürür. HTTP 202 durum kodu, istemciye Web sunucusunun iletiyi işlemeye başladığını gösterir. Bu nedenle, bir XML Web hizmeti istemcisi Web sunucusunun iletiyi başarıyla işlediğine dair bir bildirim almaz.

Tek yönlü yöntemlerin dönüş değeri veya parametresi out olamaz.

.NET Framework sürüm 1.0 XML Web hizmeti yöntemlerini SoapRpcMethodAttribute kullanıyorsanız, özelliği olarak ayarlanmış trueveya SoapDocumentMethodAttribute özniteliği uygulanmışsaOneWay, statik Current özelliği kullanarak bunlara HttpContext erişime izin verme. öğesine erişmek HttpContextiçin, öğesinden WebService XML Web hizmeti yöntemini uygulayan sınıfını türetin ve özelliğine erişin Context .