SoapRpcMethodAttribute.OneWay 屬性

定義

命名空間:

System.Web.Services.Protocols

組件:

System.Web.Services.dll

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

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

true如果 XML Web 服務客戶端沒有等待 Web 伺服器完全處理 XML Web 服務方法;否則，。 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 服務方法的處理。 一旦網頁伺服器將 反序列化 SoapServerMessage，但在呼叫 XML Web 服務方法之前，伺服器會回傳一個 HTTP 202 狀態碼。 HTTP 202 狀態碼會告訴用戶端網頁伺服器已開始處理該訊息。 因此，XML Web 服務客戶端不會收到網頁伺服器成功處理訊息的確認。

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

如果你使用 .NET Framework 1.0 版本的 XML Web 服務方法，且SoapRpcMethodAttributeSoapDocumentMethodAttributeOneWay其屬性為 或 ，且屬性設為 true，請不要允許使用靜態Current屬性存取它們。HttpContext 要存取 HttpContext，請從 衍生出實作 XML Web 服務方法 WebService 的類別，並存取該 Context 屬性。