次の方法で共有

SoapDocumentMethodAttribute.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 です。

例

次のコード例は、XML Web サービス メソッドが完了するまでクライアントが待機する必要のない XML Web サービス メソッドです。 そのため、このサンプルでは、 OneWay プロパティを true に設定します。

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

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

注釈

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

一方向メソッドには、戻り値または出力パラメーターを含めることはできません。

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

適用対象

こちらもご覧ください