SoapDocumentMethodAttribute.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#] 次の例で示す XML Web サービス メソッドは、その処理が完了するまでクライアントが待機することを要求しません。つまり、この例では OneWay プロパティが true に設定されています。

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


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

[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

参照

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