SoapRpcMethodAttribute.OneWay プロパティ

定義

名前空間:

System.Web.Services.Protocols

アセンブリ:

System.Web.Services.dll

Web サーバーが XML 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

Web サーバーが XML Web サービス メソッドの処理を完了するまで XML Web サービス クライアントが待機しない場合は 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 状態コードは、Web サーバーがメッセージの処理を開始したことをクライアントに示します。 そのため、XML Web サービス クライアントは、Web サーバーがメッセージを正常に処理したことを確認しません。

一方向メソッドには、戻り値または out パラメーターを指定できません。

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