SoapExtension.ChainStream メソッド

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

SoapExtension.ChainStream メソッド

派生クラスでオーバーライドされると、SOAP 要求または応答を格納しているメモリ バッファに SOAP 拡張機能からアクセスできます。

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

Visual Basic (宣言)

Public Overridable Function
 ChainStream ( _
    stream As Stream _
) As Stream

Visual Basic (使用法)

Dim instance As SoapExtension
Dim stream As Stream
Dim returnValue As Stream

returnValue = instance.ChainStream(stream)

C#

public virtual Stream ChainStream (
    Stream stream
)

C++

public:
virtual Stream^ ChainStream (
    Stream^ stream
)

J#

public Stream ChainStream (
    Stream stream
)

JScript

public function ChainStream (
    stream : Stream
) : Stream

パラメータ

stream

SOAP 要求または応答を格納しているメモリ バッファ。

戻り値
この SOAP 拡張機能により変更できる新しいメモリ バッファを表す Stream。

解説

ChainStream は、ワイヤ上で送信されるか、返される SOAP メッセージに一番近い実際のデータを優先度が高い SOAP 拡張機能により変更できるようにします。

SOAP 拡張機能は ChainStream に渡された Stream および ChainStream から返された Stream の参照を保存します。SOAP 拡張機能が XML Web サービス メソッドと共に動作するように設定されている場合は、ChainStream に渡される Stream に、BeforeDeserializeSoapMessageStage でシリアル化された SOAP 要求が格納されます。同様に、ChainStream から返された Stream の参照はシリアル化が発生したときに書き込まれ、シリアル化された SOAP 応答が AfterSerializeSoapMessageStage に格納されます。

使用例

ChainStream に渡された Stream と ChainStream から返された Stream をそれぞれ、oldStream メンバ変数と newStream メンバ変数に格納する例を次に示します。

Visual Basic

Public Overrides Function
 ChainStream(stream As Stream) As Stream
    m_oldStream = stream
    m_newStream = New MemoryStream()
    Return m_newStream
End Function

C#

public override Stream ChainStream( Stream stream ){
    oldStream = stream;
    newStream = new MemoryStream();
    return newStream;
}

C++

public:
   virtual Stream^ ChainStream( Stream^ stream ) override
   {
      oldStream = stream;
      newStream = gcnew MemoryStream;
      return newStream;
   }

J#

public Stream ChainStream(Stream stream)
{
    oldStream = stream;
    newStream = new MemoryStream();
    return newStream;
} //ChainStream

プラットフォーム

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

参照

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