SoapDocumentMethodAttribute.OneWay Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
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 true
ayarlarOneWay.
<%@ 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 true
ayarlandığı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 true
olmaz. öğesine erişmek HttpContextiçin, öğesinden WebService XML Web hizmeti yöntemini uygulayan sınıfını türetip özelliğine erişin Context .