Sdílet prostřednictvím

MessageBuffer Třída

Definice

Obor názvů:
System.ServiceModel.Channels
Sestavení:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
Sestavení:
System.ServiceModel.Primitives.dll
Sestavení:
System.ServiceModel.dll
Balíček:
System.ServiceModel.Primitives v10.0.652802
Zdroj:
MessageBuffer.cs
Zdroj:
MessageBuffer.cs
Zdroj:
MessageBuffer.cs

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

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
Object
MessageBuffer
Implementuje
IDisposable IXPathNavigable

Poznámky

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

Instance MessageBuffer je vytvořena voláním CreateBufferedCopyMessage instance. Pak se vytvoří a vrátí nový MessageBuffer , který předpokládá vlastnictví Message celého obsahu do paměti.

Chcete-li načíst kopii Message z MessageBuffer, musíte volat CreateMessage metodu MessageBuffer. Vrátí se stejná kopie původní Message instance, kterou jste zadali.

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

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

Zvláštní poznámka pro spravované uživatele C++, kteří pocházejí 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í, že kompilátor automaticky vygeneruje IDisposable.
  • Vyhněte se nenákazovým členům: mohou způsobit, že kompilátor automaticky vygeneruje IDisposable.
  • Vyhněte se finalizačním metodám; ale pokud ho zahrnete, měli byste potlačit upozornění sestavení a volat SuppressFinalize(Object) a finalizátor samotný z (On)(Begin)Close (a/nebo OnAbort), aby emuloval, co by bylo automaticky generované IDisposable chování.

Konstruktory

Name Description
MessageBuffer()

Inicializuje novou instanci MessageBuffer třídy.

Vlastnosti

Name Description
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

Name Description
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 zdědit.
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(Int32)

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

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

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

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

Slouží jako výchozí funkce hash.

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

Získá Type aktuální instance.

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

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

(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 datového proudu.

Explicitní implementace rozhraní

Name Description
IDisposable.Dispose()

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

Platí pro