Condividi tramite


MessageBuffer Classe

Definizione

Rappresenta un buffer di memoria nel quale viene archiviato un intero messaggio per un utilizzo futuro.

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
Ereditarietà
MessageBuffer
Implementazioni

Commenti

Il corpo di un'istanza Message è può essere utilizzato o scritto una sola volta. Se si desidera utilizzare un'istanza Message più volte, è necessario utilizzare la classe MessageBuffer per archiviare completamente un'intera istanza Message nella memoria.

Un'istanza MessageBuffer viene costruita chiamando il metodo CreateBufferedCopy di un'istanza Message. Viene quindi creata e restituita una nuova classe MessageBuffer che presuppone la proprietà della classe Message e legge l'intero contenuto nella memoria.

Per recuperare una copia di una classe Message dalla classe MessageBuffer, è necessario chiamare il metodo CreateMessage della classe MessageBuffer. Restituisce una copia identica dell'istanza Message originale fornita.

È possibile controllare la dimensione massima del buffer impostando la proprietà BufferSize sul numero massimo di byte desiderato. Questo numero non comprende necessariamente allocazioni temporanee relative alla compilazione del buffer o proprietà associate al messaggio.

Quando un'istanza MessageBuffer non viene più utilizzata, è necessario chiuderla sempre chiamando Close . In tal modo è possibile che le risorse di sistema vengano potenzialmente sbloccate prima.

Nota speciale in caso di derivazione da questa classe in C++ gestito:

  • Inserire il codice di pulizia in (On)(Begin)Close (e/o OnAbort), non in un distruttore.

  • Evitare i distruttori: comportano la generazione automatica dell'interfaccia IDisposable da parte del compilatore

  • Evitare membri di non riferimento: possono comportare la generazione automatica dell'interfaccia IDisposable da parte del compilatore

  • Evitare i finalizzatori. Se tuttavia si include un finalizzatore, è necessario annullare l'avviso di compilazione e chiamare il metodo SuppressFinalize(Object) e il finalizzatore stesso mediante (On)(Begin)Close (e/o OnAbort) al fine di emulare il comportamento dell'interfaccia IDisposable che sarebbe stata generata automaticamente.

Costruttori

MessageBuffer()

Inizializza una nuova istanza della classe MessageBuffer.

Proprietà

BufferSize

Ottiene il numero approssimativo di byte utilizzati da questa istanza MessageBuffer.

MessageContentType

Ottiene il tipo di contenuto dei messaggi archiviati in questo buffer.

Metodi

Close()

Finisce di utilizzare il buffer.

CreateMessage()

Restituisce una copia del messaggio originale.

CreateNavigator()

Crea un nuovo oggetto XPathNavigator per spostarsi in questo oggetto. Questo metodo non può essere ereditato.

CreateNavigator(Int32)

Crea un nuovo oggetto XPathNavigator per spostarsi in questo oggetto, con lo strumento di spostamento posizionato sul nodo specificato.

CreateNavigator(Int32, XmlSpace)

Crea un nuovo oggetto XPathNavigator per spostarsi in questo oggetto, con lo strumento di spostamento posizionato sul nodo e nell'ambito xml:space specificati.

CreateNavigator(XmlSpace)

Crea un nuovo oggetto XPathNavigator per spostarsi in questo oggetto, con l'ambito xml:space specificato.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
WriteMessage(Stream)

Scrive l'intero contenuto di questo buffer nel flusso I/O specificato.

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Rilascia le risorse non gestite usate da MessageBuffer e, facoltativamente, le risorse gestite. Questo metodo non può essere ereditato.

Si applica a