SoapRpcMethodAttribute.OneWay 屬性

定義

命名空間:

System.Web.Services.Protocols

組件:

System.Web.Services.dll

取得或設定 XML Web Service 用戶端是否等候 Web 伺服器完成處理 XML Web Service 方法。

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

屬性值

Boolean

如果 XML Web Service 用戶端不會等候 Web 伺服器完整地處理 XML Web Service 方法，則為 true，否則為 false。 預設為 false。

範例

下列程式碼範例會將 OneWay 屬性設定為 true 。

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

備註

當 XML Web 服務方法的 OneWay 屬性設定為 true 時，XML Web 服務用戶端不需要等候 Web 服務器完成 XML Web 服務方法的處理。 一旦 Web 服務器已還原序列化 SoapServerMessage ，但在叫用 XML Web 服務方法之前，伺服器會傳回 HTTP 202 狀態碼。 HTTP 202 狀態碼會向用戶端指出網頁伺服器已開始處理訊息。 因此，XML Web 服務用戶端不會收到 Web 服務器已成功處理訊息的通知。

單向方法不能有傳回值或任何 out 參數。

如果您使用 .NET Framework 1.0 版 XML Web 服務方法，這些方法已 SoapRpcMethodAttribute 將 或 SoapDocumentMethodAttribute 屬性套用至它們 OneWay ，且屬性設定 true 為 ，則不允許使用靜態 Current 屬性存取它們 HttpContext 。 若要存取 HttpContext ，請從 WebService 衍生實作 XML Web 服務方法的 類別，並存取 Context 屬性。