MessageBuffer クラス

定義

後で使用するためにメッセージ全体を格納しているメモリ バッファーを表します。

public ref class MessageBuffer abstract : IDisposable
public ref class MessageBuffer abstract : IDisposable, System::Xml::XPath::IXPathNavigable
public abstract class MessageBuffer : IDisposable
public abstract class MessageBuffer : IDisposable, System.Xml.XPath.IXPathNavigable
type MessageBuffer = class
    interface IDisposable
type MessageBuffer = class
    interface IXPathNavigable
    interface IDisposable
Public MustInherit Class MessageBuffer
Implements IDisposable
Public MustInherit Class MessageBuffer
Implements IDisposable, IXPathNavigable
継承
MessageBuffer
実装

注釈

Message インスタンスの本文は消費されるか、または 1 回だけ書き込まれます。 Message インスタンスを複数回にわたって消費する場合は、MessageBuffer インスタンス全体を完全にメモリに保存するために Message クラスを使用する必要があります。

MessageBuffer インスタンスは、CreateBufferedCopy インスタンスの Message を呼び出すことにより構築されます。 次に、新しい MessageBuffer が作成されて返されます。これは、Message の所有権を引き継ぎ、その内容全体をメモリ内に読み取ります。

Message から MessageBuffer のコピーを取得するには、CreateMessageMessageBuffer メソッドを呼び出す必要があります。 これにより、指定した元の Message インスタンスの完全なコピーが返されます。

BufferSize を目的の最大バイト数に設定することにより、バッファーの最大サイズを制御できます。 この数は、バッファーの構築に関連する一時的な割り当て、またはメッセージに関連付けられたプロパティには必ずしも適用されません。

操作が完了したら常に、MessageBuffer を呼び出すことにより Close インスタンスを閉じる必要があります。 これにより、システム リソースを迅速に解放できる可能性があります。

このクラスから派生するマネージド C++ ユーザーに対する特別な注意 :

  • クリーンアップ コードは、デストラクターではなく (On)(Begin)Close (または OnAbort のどちらか一方または両方) に置いてください。

  • デストラクターは使用しないでください。使用すると、コンパイラが IDisposable を自動生成します。

  • 非参照メンバーを使用しないでください。使用すると、コンパイラが IDisposable を自動生成します。

  • ファイナライザーを使用しないでください。使用する場合は、ビルド警告を抑制し、SuppressFinalize(Object) を呼び出し、ファイナライザー自体を (On)(Begin)Close (または OnAbort のどちらか一方または両方) から呼び出して、自動生成される IDisposable の動作をエミュレートする必要があります。

コンストラクター

MessageBuffer()

MessageBuffer クラスの新しいインスタンスを初期化します。

プロパティ

BufferSize

この MessageBuffer が使用する概算のバイト数を取得します。

MessageContentType

このバッファーに保存されたメッセージの内容の種類を取得します。

メソッド

Close()

バッファーの使用を終了します。

CreateMessage()

元のメッセージのコピーを返します。

CreateNavigator()

このオブジェクト内を移動するための、新しい XPathNavigator オブジェクトを作成します。 このメソッドは継承できません。

CreateNavigator(Int32)

このオブジェクト内を移動するための新しい XPathNavigator オブジェクトを作成し、ナビゲーターを指定したノードに配置します。

CreateNavigator(Int32, XmlSpace)

このオブジェクト内を移動するための新しい XPathNavigator オブジェクトを作成し、ナビゲーターを指定したノードと xml:space スコープに配置します。

CreateNavigator(XmlSpace)

XPathNavigator スコープを指定して、このオブジェクト内を移動するための新しい xml:space オブジェクトを作成します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
WriteMessage(Stream)

このバッファーの内容全体を指定した IO ストリームに書き込みます。

明示的なインターフェイスの実装

IDisposable.Dispose()

MessageBuffer によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 このメソッドは継承できません。

適用対象