SoapRpcMethodAttribute.OneWay プロパティ

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

プロパティ値

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 サービス メソッドの処理を完了するまで待機する必要はありません。 Web サーバーが SoapServerMessageを逆シリアル化したが、XML Web サービス メソッドを呼び出す前に、サーバーは HTTP 202 状態コードを返します。 HTTP 202 状態コードは、Web サーバーがメッセージの処理を開始したことをクライアントに示します。 そのため、XML Web サービス クライアントは、Web サーバーがメッセージを正常に処理したことを確認しません。

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

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