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. Varsayılan değer false değeridir.

Ö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 Xml Web hizmeti yöntemini işlemeyi tamamlamak için Web sunucusunun 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 parametreleri olamaz.

veya özniteliğine uygulanmış OneWay olan .NET Framework sürüm 1.0 XML Web hizmeti yöntemlerini SoapRpcMethodAttributeSoapDocumentMethodAttribute kullanıyorsanız, statik özelliğini truekullanarak Current bunlara HttpContext erişimi yoktur. öğesine erişmek HttpContextiçin, öğesinden WebService XML Web hizmeti yöntemini uygulayan sınıfı türetin ve özelliğine erişin Context .

Ayrıca bkz.

• SoapServerMessage