SoapRpcMethodAttribute.OneWay プロパティ

Web サーバーが XML Web サービス メソッドの処理を完了するまで XML Web サービス クライアントが待機するかどうかを示す値を取得または設定します。

Public Property OneWay As Boolean
[C#]
public bool OneWay {get; set;}
[C++]
public: __property bool get_OneWay();public: __property void set_OneWay(bool);
[JScript]
public function get OneWay() : Boolean;public function set OneWay(Boolean);

プロパティ値

Web サーバーが XML Web サービス メソッドの処理を完了するまで XML Web サービス クライアントが待機しない場合は true 。既定値は false です。

解説

XML Web サービス メソッドの OneWay プロパティが true に設定されている場合、その XML Web サービスのクライアントは、Web サーバーが XML Web サービス メソッドの処理を完了するまで待機する必要はありません。この場合、Web サーバーは SoapServerMessage を逆シリアル化した直後から XML Web サービス メソッドが呼び出されるまでの間に、HTTP 202 ステータス コードを返します。HTTP 202 ステータス コードは、Web サーバーがメッセージの処理を開始したことをクライアントに通知します。このため、XML Web サービス クライアントは Web サーバーがメッセージを正常に処理したことを示す受信確認は受信しません。

一方向のメソッドは、戻り値も out パラメータも持つことはできません。

使用している .NET Framework Version 1.0 XML Web サービスのメソッドに SoapRpcMethodAttribute 属性または SoapDocumentMethodAttribute 属性が適用されており、 OneWay プロパティが true に設定されている場合は、静的な Current プロパティを使用して HttpContext にアクセスしないでください。 HttpContext にアクセスするには、XML Web サービスのメソッドを実装するクラスを WebService から派生し、 Context プロパティにアクセスします。

使用例

[Visual Basic, C#] OneWay プロパティを true に設定するコード例を次に示します。

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


[C#] 
<%@ 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.
      }      
 
 }

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SoapRpcMethodAttribute クラス | SoapRpcMethodAttribute メンバ | System.Web.Services.Protocols 名前空間