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

継承

Object

MessageBuffer

実装

IDisposable IXPathNavigable

注釈

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

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

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

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

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

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

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

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

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

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

コンストラクター

プロパティ

メソッド

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

適用対象