MessageBuffer Clase

  • Referencia

Definición

Espacio de nombres:
System.ServiceModel.Channels
Ensamblado:
System.ServiceModel.Primitives.dll
Ensamblado:
System.ServiceModel.dll

Representa un búfer de la memoria que almacena un mensaje completo para su futura utilización.

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

Comentarios

El cuerpo de una instancia Message se puede utilizar o escribir sólo una vez. Si desea utilizar más de una vez una instancia Message, debería utilizar la clase MessageBuffer para almacenar completamente una instancia Message completa en la memoria.

Una instancia MessageBuffer se construye llamando a CreateBufferedCopy de una instancia Message. Un nuevo MessageBuffer se crea y devuelve a continuación que asume la propiedad de Message y lee el contenido completo en la memoria.

Para recuperar una copia de Message de MessageBuffer, debe llamar al método CreateMessage de MessageBuffer. Esto devuelve una copia idéntica de la instancia Message original que proporcionó.

Puede controlar el tamaño máximo del búfer estableciendo BufferSize en el número máximo de bytes deseados. Este número necesariamente no cubre cualquier asignación transitoria relacionada con compilar el búfer o las propiedades adjuntadas al mensaje.

Siempre debería cerrar una instancia MessageBuffer llamando a Close cuando acabe de trabajar con ella. De esta forma, los recursos del sistema posiblemente se puedan liberara antes.

Nota especial para los usuarios de C++ que deriven de esta clase:

  • Coloque su código de limpieza en (On)(Begin)Close (y/o OnAbort), no en un destructor.

  • Evite los destructores: hacen que el compilador genere automáticamente IDisposable

  • Evite los miembros sin referencia: pueden hacer que el compilador genere automáticamente IDisposable

  • Evite los finalizadores; pero si incluye uno, debería suprimir la advertencia de compilación y llamar a SuppressFinalize(Object) y al propio finalizador desde (On)(Begin)Close (y/o OnAbort) para emular lo que habría sido el comportamiento de IDisposable generado automáticamente.

Constructores

MessageBuffer()

Inicializa una nueva instancia de la clase MessageBuffer.

Propiedades

BufferSize

Obtiene el número aproximado de bytes utilizado por MessageBuffer.
MessageContentType

Obtiene el tipo de contenido del mensaje almacenado en este búfer.

Métodos

Close()

Termina de trabajar con el búfer.
CreateMessage()

Devuelve una copia del mensaje original.
CreateNavigator()

Crea un nuevo objeto XPathNavigator para navegar por este objeto. Este método no se puede heredar.
CreateNavigator(Int32)

Crea un nuevo objeto XPathNavigator para navegar por este objeto, con el navegador colocado en el nodo especificado.
CreateNavigator(Int32, XmlSpace)

Crea un nuevo objeto XPathNavigator para navegar por este objeto, con el navegador colocado en el nodo especificado y el ámbito xml:space.
CreateNavigator(XmlSpace)

Crea un nuevo objeto XPathNavigator para navegar por este objeto, con el ámbito xml:space especificado.
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
WriteMessage(Stream)

Escribe el contenido completo de este búfer en la secuencia de E/S especificada.

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Libera los recursos no administrados que usa MessageBuffer y, de forma opcional, libera los recursos administrados. Este método no se puede heredar.

Se aplica a