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 bitirmesini 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

BIR XML Web hizmeti yöntemi OneWay özelliği olarak trueayarlandığında, XML Web hizmeti istemcisinin Xml Web hizmeti yöntemini işlemeyi tamamlamak için Web sunucusunun 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.

özelliği olarak ayarlanmış trueveya SoapDocumentMethodAttribute özniteliğine sahip OneWay .NET Framework sürüm 1.0 XML Web hizmeti yöntemlerini SoapRpcMethodAttribute kullanıyorsanız, 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ı türetin ve özelliğine erişin Context .