Sdílet prostřednictvím


MessageBuffer Třída

Definice

Představuje vyrovnávací paměť, která ukládá celou zprávu pro budoucí využití.

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
Dědičnost
MessageBuffer
Implementuje

Poznámky

Tělo Message instance může být spotřebováno nebo zapsáno pouze jednou. Pokud chcete využívat Message instanci více než jednou, měli byste použít MessageBuffer třídu k úplnému uložení celé Message instance do paměti.

Instance MessageBuffer se vytvoří voláním CreateBufferedCopyMessage instance. Pak se vytvoří a vrátí nový MessageBuffer objekt, který převezme vlastnictví objektu Message a načte celý obsah do paměti.

Chcete-li načíst kopii z MessageMessageBuffer, musíte volat metodu CreateMessageMessageBuffer. Vrátí stejnou kopii původní Message instance, kterou jste zadali.

Maximální velikost vyrovnávací paměti můžete řídit nastavením BufferSize maximálního požadovaného počtu bajtů. Toto číslo nemusí nutně zahrnovat přechodná přidělení související s vytvořením vyrovnávací paměti nebo vlastnosti připojené ke zprávě.

Po dokončení práce s ní byste vždy měli instanci zavřít MessageBuffer voláním Close . To umožňuje, aby se systémové prostředky uvolnily dříve.

Zvláštní poznámka pro uživatele spravovaného jazyka C++, kteří jsou odvozeni z této třídy:

  • Vložte kód čištění do (On)(Begin)Close (a/nebo OnAbort), ne do destruktoru.

  • Vyhněte se destruktorům: způsobí automatické generování kompilátoru. IDisposable

  • Vyhněte se ne referenčním členům: Můžou způsobit automatické vygenerování kompilátoru. IDisposable

  • Vyhněte se finalizátorům; Pokud ale zahrnete jeden, měli byste potlačit upozornění sestavení a volat SuppressFinalize(Object) a finalizátor samotný z (On)(Begin)Close (nebo OnAbort), abyste emulovali, jaké by bylo automaticky generované IDisposable chování.

Konstruktory

MessageBuffer()

Inicializuje novou instanci MessageBuffer třídy.

Vlastnosti

BufferSize

Získá přibližný počet bajtů spotřebovaných tímto MessageBuffer.

MessageContentType

Získá typ obsahu zprávy uložené v této vyrovnávací paměti.

Metody

Close()

Dokončí práci s vyrovnávací pamětí.

CreateMessage()

Vrátí kopii původní zprávy.

CreateNavigator()

Vytvoří nový XPathNavigator objekt pro navigaci v tomto objektu. Tuto metodu nelze dědit.

CreateNavigator(Int32)

Vytvoří nový XPathNavigator objekt pro navigaci v tomto objektu s navigátorem umístěným na zadaném uzlu.

CreateNavigator(Int32, XmlSpace)

Vytvoří nový XPathNavigator objekt pro navigaci v tomto objektu s navigátorem umístěným na zadaném uzlu a xml:space oboru.

CreateNavigator(XmlSpace)

Vytvoří nový XPathNavigator objekt pro navigaci v tomto objektu se zadaným xml:space oborem.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
WriteMessage(Stream)

Zapíše celý obsah této vyrovnávací paměti do zadaného vstupně-výstupního streamu.

Explicitní implementace rozhraní

IDisposable.Dispose()

Uvolní nespravované prostředky používané MessageBuffer nástrojem a volitelně uvolní spravované prostředky. Tuto metodu nelze dědit.

Platí pro