MessageBuffer Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Quelle:

MessageBuffer.cs

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

public ref class MessageBuffer abstract : IDisposable

public abstract class MessageBuffer : IDisposable

type MessageBuffer = class
    interface IDisposable

Public MustInherit Class MessageBuffer
Implements IDisposable

Vererbung

Object

MessageBuffer

Implementiert

IDisposable

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