MessageBuffer Třída

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v6.2.0

Zdroj:

MessageBuffer.cs

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

public ref class MessageBuffer abstract : IDisposable

public abstract class MessageBuffer : IDisposable

type MessageBuffer = class
    interface IDisposable

Public MustInherit Class MessageBuffer
Implements IDisposable

Dědičnost

Object

MessageBuffer

Implementuje

IDisposable

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.
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.