Condividi tramite

MessageBuffer Classe

Definizione

Spazio dei nomi:
System.ServiceModel.Channels
Assembly:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll
Pacchetto:
System.ServiceModel.Primitives v10.0.652802
Origine:
MessageBuffer.cs
Origine:
MessageBuffer.cs
Origine:
MessageBuffer.cs

Rappresenta un buffer di memoria che archivia 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à
Object
MessageBuffer
Implementazioni
IDisposable IXPathNavigable

Commenti

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

Un'istanza MessageBuffer viene costruita chiamando CreateBufferedCopy un'istanza Message di . Viene quindi creato e restituito un nuovo MessageBuffer oggetto , che assume la proprietà di Message e legge l'intero contenuto in memoria.

Per recuperare una copia di da MessageMessageBuffer, è necessario chiamare il CreateMessage metodo dell'oggetto MessageBuffer. Verrà restituita una copia identica dell'istanza originale Message specificata.

È possibile controllare le dimensioni massime del buffer impostando BufferSize il numero massimo di byte desiderato. Questo numero non copre necessariamente le allocazioni temporanee correlate alla compilazione del buffer o alle proprietà associate al messaggio.

È consigliabile chiudere sempre un'istanza MessageBuffer chiamando Close al termine dell'utilizzo. In questo modo, le risorse di sistema possono essere liberate prima.

Nota speciale per gli utenti C++ gestiti che derivano da questa classe:

  • Inserire il codice di pulizia in (On)(Begin)Close (and/or OnAbort), non in un distruttore.
  • Evitare distruttori: causano la generazione IDisposableautomatica del compilatore.
  • Evitare membri non di riferimento: possono causare la generazione IDisposableautomatica del compilatore.
  • Evitare finalizzatori; ma se ne includi uno, devi eliminare l'avviso di compilazione e chiamare SuppressFinalize(Object) e il finalizzatore stesso da (On)(Begin)Close (e/o OnAbort) per emulare il comportamento generato automaticamente IDisposable .

Costruttori

Nome Descrizione
MessageBuffer()

Inizializza una nuova istanza della classe MessageBuffer.

Proprietà

Nome Descrizione
BufferSize

Ottiene il numero approssimativo di byte utilizzati da questo MessageBufferoggetto .
MessageContentType

Ottiene il tipo di contenuto del messaggio archiviato in questo buffer.

Metodi

Nome Descrizione
Close()

Termina l'uso del buffer.
CreateMessage()

Restituisce una copia del messaggio originale.
CreateNavigator()

Crea un nuovo XPathNavigator oggetto per spostarsi in questo oggetto. Questo metodo non può essere ereditato.
CreateNavigator(Int32, XmlSpace)

Crea un nuovo XPathNavigator oggetto per lo spostamento in questo oggetto, con lo strumento di navigazione posizionato nel nodo e xml:space nell'ambito specificati.
CreateNavigator(Int32)

Crea un nuovo XPathNavigator oggetto per lo spostamento in questo oggetto, con lo strumento di navigazione posizionato sul nodo specificato.
CreateNavigator(XmlSpace)

Crea un nuovo XPathNavigator oggetto per spostarsi in questo oggetto, con l'ambito specificato xml:space .
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 il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(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 di I/O specificato.

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IDisposable.Dispose()

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

Si applica a