MessageBuffer Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v6.2.0

Source:

MessageBuffer.cs

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

public ref class MessageBuffer abstract : IDisposable

public abstract class MessageBuffer : IDisposable

type MessageBuffer = class
    interface IDisposable

Public MustInherit Class MessageBuffer
Implements IDisposable

Ereditarietà

Object

MessageBuffer

Implementazioni

IDisposable

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.
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.