Udostępnij za pośrednictwem


MessageBuffer Klasa

Definicja

Reprezentuje bufor pamięci, który przechowuje cały komunikat na potrzeby przyszłego użycia.

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
Dziedziczenie
MessageBuffer
Implementuje

Uwagi

Treść Message wystąpienia można używać lub zapisywać tylko raz. Jeśli chcesz używać Message wystąpienia więcej niż raz, należy użyć MessageBuffer klasy , aby całkowicie zapisać całe Message wystąpienie w pamięci.

Wystąpienie MessageBuffer jest tworzone przez wywołanie CreateBufferedCopy Message wystąpienia. Następnie zostanie utworzona i zwrócona nowa MessageBuffer , która przyjmuje własność elementu Message i odczytuje całą zawartość do pamięci.

Aby pobrać kopię elementu Message z klasy MessageBuffer, należy wywołać CreateMessage metodę MessageBuffer. Spowoduje to zwrócenie identycznej kopii podanego oryginalnego Message wystąpienia.

Maksymalny rozmiar buforu można kontrolować, ustawiając BufferSize maksymalną liczbę żądanych bajtów. Ta liczba nie musi obejmować żadnych przejściowych alokacji związanych z tworzeniem buforu ani właściwości dołączonych do komunikatu.

Zawsze należy zamknąć MessageBuffer wystąpienie, wywołując wywołanie Close po zakończeniu pracy z nim. Dzięki temu zasoby systemowe mogą być zwalniane szybciej.

Uwaga specjalna dla użytkowników zarządzanego języka C++ pochodzącego z tej klasy:

  • Umieść kod oczyszczania w (On)(Begin)Close (i/lub OnAbort), a nie w destruktorze.

  • Unikaj destruktorów: powodują one automatyczne generowanie kompilatora IDisposable

  • Unikaj elementów członkowskich innych niż odwołania: mogą powodować automatyczne generowanie kompilatora IDisposable

  • Unikaj finalizatorów; ale w przypadku dołączenia należy pominąć ostrzeżenie i wywołanie SuppressFinalize(Object) kompilacji oraz sam finalizator z (On)(Begin)Close (i/lub OnAbort) w celu emulacji tego, co byłoby generowane IDisposable automatycznie.

Konstruktory

MessageBuffer()

Inicjuje nowe wystąpienie klasy MessageBuffer.

Właściwości

BufferSize

Pobiera przybliżoną liczbę bajtów używanych przez tę MessageBufferwartość .

MessageContentType

Pobiera typ zawartości komunikatu przechowywanej w tym buforze.

Metody

Close()

Kończy pracę z buforem.

CreateMessage()

Zwraca kopię oryginalnej wiadomości.

CreateNavigator()

Tworzy nowy XPathNavigator obiekt do nawigowania po tym obiekcie. Nie można dziedziczyć tej metody.

CreateNavigator(Int32)

Tworzy nowy XPathNavigator obiekt do nawigowania po tym obiekcie z nawigatorem umieszczonym w określonym węźle.

CreateNavigator(Int32, XmlSpace)

Tworzy nowy XPathNavigator obiekt do nawigowania po tym obiekcie z nawigatorem umieszczonym w określonym węźle i xml:space zakresie.

CreateNavigator(XmlSpace)

Tworzy nowy XPathNavigator obiekt do nawigowania po tym obiekcie z określonym xml:space zakresem.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
WriteMessage(Stream)

Zapisuje całą zawartość tego buforu do określonego strumienia we/wy.

Jawne implementacje interfejsu

IDisposable.Dispose()

Zwalnia zasoby niezarządzane używane przez element MessageBuffer i opcjonalnie zwalnia zasoby zarządzane. Nie można dziedziczyć tej metody.

Dotyczy