MessageBuffer Класс

Определение

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

Наследование

Object

MessageBuffer

Реализации

IDisposable IXPathNavigable

Комментарии

Текст экземпляра Message можно использовать только один раз или записать. Если вы хотите использовать Message экземпляр более одного раза, следует использовать MessageBuffer класс для полного хранения всего Message экземпляра в памяти.

MessageBuffer Экземпляр создается путем вызова CreateBufferedCopy экземпляраMessage. Затем создается и возвращается новое MessageBuffer , которое предполагает владение Message и считывает все содержимое в память.

Чтобы получить копию Message из объекта MessageBuffer, необходимо вызвать CreateMessage метод MessageBuffer. Возвращает идентичную копию предоставленного исходного Message экземпляра.

Максимальный размер буфера можно контролировать, установив BufferSize максимальное число байтов. Это число не обязательно охватывает временные выделения, связанные с созданием буфера или свойствами, присоединенными к сообщению.

При завершении работы с экземпляром MessageBuffer всегда следует закрыть экземпляр Close . Это позволяет системным ресурсам потенциально освободиться раньше.

Специальное примечание для пользователей Managed C++, производных от этого класса:

• Поместите код очистки в (On)(Begin)Close (and/or OnAbort), а не в деструктор.
• Избегайте деструкторов: они вызывают автоматическое создание IDisposableкомпилятором.
• Избегайте элементов без ссылок: они могут привести к автоматическому созданию IDisposableкомпилятора.
• Избегайте завершения; но если включить его, необходимо отключить предупреждение сборки и вызвать SuppressFinalize(Object) и завершить работу из (On)(Begin)Close (and/or OnAbort), чтобы эмулировать то, что было бы автоматически созданным IDisposable поведением.