SoapMessageStageとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SoapMessage.Stage プロパティ

SoapMessage の SoapMessageStage を取得します。

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Stage As SoapMessageStage

Visual Basic (使用法)

Dim instance As SoapMessage
Dim value As SoapMessageStage

value = instance.Stage

public SoapMessageStage Stage { get; }

C++

public:
property SoapMessageStage Stage {
    SoapMessageStage get ();
}

/** @property */
public SoapMessageStage get_Stage ()

JScript

public function get Stage
 () : SoapMessageStage

プロパティ値
SoapMessage の SoapMessageStage。

解説

Stage プロパティには、任意の SoapMessageStage でアクセスできます。

使用例

SoapExtension.ProcessMessage メソッド内の SoapMessageStage を確認するためのコード例を次に示します。

Visual Basic

Public Overrides Sub ProcessMessage(message
 As SoapMessage)
    Select Case message.Stage
        
        Case SoapMessageStage.BeforeSerialize
        
        Case SoapMessageStage.AfterSerialize
            WriteOutput(message)
        
        Case SoapMessageStage.BeforeDeserialize
            WriteInput(message)
        
        Case SoapMessageStage.AfterDeserialize
        
        Case Else
                Throw New Exception("invalid
 stage")
    End Select
End Sub

public override void ProcessMessage(SoapMessage
 message) {
        switch (message.Stage) {

        case SoapMessageStage.BeforeSerialize:
            break;

        case SoapMessageStage.AfterSerialize:
            WriteOutput( message );
            break;

        case SoapMessageStage.BeforeDeserialize:
            WriteInput( message );
            break;

        case SoapMessageStage.AfterDeserialize:
            break;

        default:
            throw new Exception("invalid stage");
        }
}

C++

public:
   virtual void ProcessMessage( SoapMessage^ message ) override
   {
      switch ( message->Stage )
      {
         case SoapMessageStage::BeforeSerialize:
            break;

         case SoapMessageStage::AfterSerialize:
            WriteOutput( message );
            break;

         case SoapMessageStage::BeforeDeserialize:
            WriteInput( message );
            break;

         case SoapMessageStage::AfterDeserialize:
            break;

         default:
            throw gcnew Exception( "invalid stage" );
      }
   }

public void ProcessMessage(SoapMessage message)
 throws Exception
{
    switch (message.get_Stage()) {
        case SoapMessageStage.BeforeSerialize :
            break;

        case SoapMessageStage.AfterSerialize :
            WriteOutput(message);
            break;

        case SoapMessageStage.BeforeDeserialize :
            WriteInput(message);
            break;

        case SoapMessageStage.AfterDeserialize :
            break;

        default :
            throw new Exception("invalid stage");
    }
} //ProcessMessage

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SoapMessage クラス
SoapMessage メンバ
System.Web.Services.Protocols 名前空間

SoapMessageStage 列挙体

SOAP メッセージの処理段階を指定します。

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Enumeration SoapMessageStage

Visual Basic (使用法)

Dim instance As SoapMessageStage

public enum SoapMessageStage

C++

public enum class SoapMessageStage

public enum SoapMessageStage

JScript

public enum SoapMessageStage

メンバ

	メンバ名	説明
	AfterDeserialize	SoapMessage の直後の段階が SOAP メッセージからオブジェクトに逆シリアル化されます。 SoapClientMessage 処理時に、AfterDeserialize 段階は、XML Web サービスメソッドの呼び出しからの応答を含む SOAP メッセージがオブジェクトに逆シリアル化された後、クライアントが逆シリアル化の結果を受け取る前に発生します。 SoapServerMessage 処理時に、AfterDeserialize 段階は、XML Web サービスメソッドの呼び出しを表す SOAP メッセージを含むネットワーク要求がオブジェクトに逆シリアル化された後、XML Web サービスメソッドを表すオブジェクトでメソッドが呼び出される前に発生します。
	AfterSerialize	SoapMessage がシリアル化された直後で、さらに SOAP メッセージがネットワークをとおして送信される前の段階。 SoapClientMessage 処理時に、AfterSerialize 段階は、クライアントが XML Web サービスメソッドを呼び出し、パラメータが XML にシリアル化された後、その XML を含んでいる SOAP メッセージがネットワークで送信される前に発生します。 SoapServerMessage 処理時に、AfterSerialize 段階は、XML Web サービスメソッドが返されて戻り値が XML にシリアル化された後、その XML を含んでいる SOAP メッセージがネットワークで送信される前に発生します。
	BeforeDeserialize	SoapMessage がネットワークで送信された SOAP メッセージからオブジェクトに逆シリアル化される直前の段階。 SoapClientMessage 処理時に、BeforeDeserialize 段階は、XML Web サービスメソッドの呼び出しからのネットワーク応答の受信の後、SOAP メッセージを格納している応答がオブジェクトに逆シリアル化される前に発生します。 SoapServerMessage 処理時に、BeforeDeserialize 段階は、XML Web サービスメソッド呼び出しのための SOAP メッセージを格納しているネットワーク要求を Web サーバーが受信した後、SOAP メッセージがオブジェクトに逆シリアル化される前に発生します。
	BeforeSerialize	SoapMessage がシリアル化される直前の段階。 SoapClientMessage 処理時に、BeforeSerialize 段階は、クライアントが XML Web サービスメソッドを呼び出した後、呼び出しがシリアル化される前に発生します。 SoapServerMessage 処理時に、BeforeSerialize 段階は、XML Web サービスメソッドの呼び出しが返された後、戻り値がシリアル化されてネットワークをとおしてクライアントに返送される前に発生します。

解説

ASP.NET は、SOAP を使用して Web サービスを呼び出す機能拡張機構を提供します。この機能拡張機構は SoapExtension を中心とする機構であり、クライアントまたはサーバーでメッセージ処理の特定の段階でメッセージの検査や変更ができます。この列挙体は SoapMessage の処理段階を指定します。

使用例

ProcessMessage メソッドを実装する SOAP 拡張機能のフラグメントのコード例を次に示します。ProcessMessage メソッドの中で、SoapMessage は SoapMessageStage に対して固有に処理されます。

Visual Basic

  ' Process the SOAP message received and write to log file.
  Public Overrides Sub ProcessMessage(message
 As SoapMessage)
     Select Case message.Stage
        Case SoapMessageStage.BeforeSerialize
        Case SoapMessageStage.AfterSerialize
           WriteOutput(message)
        Case SoapMessageStage.BeforeDeserialize
           WriteInput(message)
        Case SoapMessageStage.AfterDeserialize
        Case Else
              Throw New Exception("invalid
 stage")
     End Select
End Sub 'ProcessMessage

// Process the SOAP message received and write to log file.
public override void ProcessMessage(SoapMessage
 message) 
{
   switch (message.Stage) 
   {
      case SoapMessageStage.BeforeSerialize:
         break;
      case SoapMessageStage.AfterSerialize:
         WriteOutput( message );
         break;
      case SoapMessageStage.BeforeDeserialize:
         WriteInput( message );
         break;
      case SoapMessageStage.AfterDeserialize:
         break;
      default:
         throw new Exception("invalid stage");
   }
}

C++

// Process the SOAP message received and write to log file.
void ProcessMessage( SoapMessage^ message )
{
   switch ( message->Stage )
   {
      case SoapMessageStage::BeforeSerialize:
         break;
      case SoapMessageStage::AfterSerialize:
         WriteOutput( message );
         break;
      case SoapMessageStage::BeforeDeserialize:
         WriteInput( message );
         break;
      case SoapMessageStage::AfterDeserialize:
         break;
      default:
         throw gcnew Exception( "invalid stage" );
   }
}

// Process the SOAP message received and write to log file.
public void ProcessMessage(SoapMessage message)
 throws Exception
{
    switch (message.get_Stage()) {
        case SoapMessageStage.BeforeSerialize:
            break;

        case SoapMessageStage.AfterSerialize:
            WriteOutput(message);
            break;

        case SoapMessageStage.BeforeDeserialize:
            WriteInput(message);
            break;

        case SoapMessageStage.AfterDeserialize:
            break;

        default:
            throw new Exception("invalid stage");
    }
} //ProcessMessage