SoapDocumentMethodAttribute.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. false varsayılan değerdir.

Örnekler

Aşağıdaki kod örneği, istemcinin XML Web hizmeti yönteminin tamamlanmasını beklemesini gerektirmeyen bir XML Web hizmeti yöntemidir. Bu nedenle, örnek özelliğini olarak trueayarlarOneWay.

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

Açıklamalar

BIR XML Web hizmeti yöntemi OneWay özelliği olarak trueayarlandığında, XML Web hizmeti istemcisinin Web sunucusunun XML Web hizmeti yöntemini işlemeyi bitirmesini beklemesi gerekmez. Web sunucusu serisini SoapServerMessagekaldırdığı anda, ancak XML Web hizmeti yöntemini çağırmadan önce 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 out parametresi olamaz.

veya özniteliğinin özelliği olarak ayarlanmış olarak uygulanmış OneWay .NET Framework sürüm 1.0 XML Web hizmeti yöntemlerini SoapRpcMethodAttribute SoapDocumentMethodAttribute kullanıyorsanız, statik Current özelliğini kullanarak bunlara HttpContext erişiminiz trueolmaz. öğesine erişmek HttpContextiçin, öğesinden WebService XML Web hizmeti yöntemini uygulayan sınıfını türetip özelliğine erişin Context .

Ayrıca bkz.

• SoapServerMessage