MessageBuffer Klasse

Definition

Stellt einen Arbeitsspeicherpuffer dar, der eine gesamte Nachricht zur zukünftigen Verwendung speichert.

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
Vererbung
MessageBuffer
Implementiert

Hinweise

Der Text einer Message-Instanz kann nur einmal verwendet oder geschrieben werden. Wenn eine Message-Instanz mehr als einmal verwendet werden soll, sollten Sie die MessageBuffer-Klasse verwenden, um eine gesamte Message-Instanz vollständig im Arbeitsspeicher zu speichern.

Eine MessageBuffer-Instanz wird durch Aufrufen von CreateBufferedCopy einer Message-Instanz konstruiert. Es wird dann ein neuer MessageBuffer erstellt und zurückgegeben, der zum Besitzer der Message wird und den gesamten Inhalt in den Arbeitsspeicher einliest.

Um eine Kopie einer Message aus dem MessageBuffer abzurufen, müssen Sie die CreateMessage-Methode vonMessageBuffer aufrufen. Hierdurch wird eine identische Kopie der ursprünglich von Ihnen bereitgestellten Message-Instanz zurückgegeben.

Sie können die maximale Größe des Puffers steuern, indem Sie BufferSize auf die maximal gewünschte Anzahl von Byte festlegen. Diese Zahl deckt nicht unbedingt alle flüchtigen Zuweisungen, die sich auf die Erstellung des Puffers beziehen, oder die mit der Nachricht verknüpften Eigenschaften ab.

Sie sollten eine MessageBuffer-Instanz immer schließen, indem Sie Close aufrufen, wenn sie nicht weiter benötigt wird. Dadurch können Systemressourcen möglicherweise früher freigegeben werden.

Spezieller Hinweis für Benutzer von Managed C++, die von dieser Klasse ableiten:

  • Fügen Sie den Bereinigungscode in (On)(Begin)Close (and/or OnAbort) ein, nicht in einen Destruktor.

  • Vermeiden Sie Destruktoren: Sie bewirken, dass der Compiler IDisposable automatisch generiert.

  • Vermeiden Sie Member ohne Verweis: Sie können bewirken, dass der Compiler IDisposable automatisch generiert.

  • Vermeiden Sie Finalizer. Wenn Sie dennoch einen Finalizer verwenden, sollten Sie die Buildwarnung unterdrücken und SuppressFinalize(Object) sowie den Finalizer über (On)(Begin)Close (and/or OnAbort) aufrufen, um das ansonsten automatisch generierte IDisposable-Verhalten zu emulieren.

Konstruktoren

MessageBuffer()

Initialisiert eine neue Instanz der MessageBuffer-Klasse.

Eigenschaften

BufferSize

Ruft die ungefähre Anzahl von Byte ab, die von diesem MessageBuffer verwendet werden.

MessageContentType

Ruft den Typ des in diesem Puffer gespeicherten Meldungsinhalts ab.

Methoden

Close()

Beendet die Arbeit mit dem Puffer.

CreateMessage()

Gibt eine Kopie der ursprünglichen Nachrichten zurück.

CreateNavigator()

Erstellt ein neues XPathNavigator-Objekt zum Navigieren in diesem Objekt. Diese Methode kann nicht vererbt werden.

CreateNavigator(Int32)

Erstellt ein neues XPathNavigator-Objekt zum Navigieren in diesem Objekt, wenn der Navigator auf dem angegebenen Knoten positioniert ist.

CreateNavigator(Int32, XmlSpace)

Erstellt ein neues XPathNavigator-Objekt zum Navigieren in diesem Objekt, wenn der Navigator auf dem angegebenen Knoten positioniert und im xml:space-Bereich ist.

CreateNavigator(XmlSpace)

Erstellt ein neues XPathNavigator-Objekt zum Navigieren in diesem Objekt, mit dem angegebenen xml:space-Bereich.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
WriteMessage(Stream)

Schreibt den gesamten Inhalt dieses Puffers in den angegebenen E/A-Stream.

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Gibt die von MessageBuffer verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. Diese Methode kann nicht vererbt werden.

Gilt für: