Formatter Classe

Definizione

Spazio dei nomi:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Formatters.dll

Source:

Formatter.cs

Attenzione

BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.

Importante

Questa API non è conforme a CLS.

Fornisce la funzionalità di base per i formattatori di serializzazione Common Language Runtime.

public ref class Formatter abstract : System::Runtime::Serialization::IFormatter

[System.CLSCompliant(false)]
[System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public abstract class Formatter : System.Runtime.Serialization.IFormatter

[<System.CLSCompliant(false)>]
[<System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type Formatter = class
    interface IFormatter

Public MustInherit Class Formatter
Implements IFormatter

Ereditarietà

Object

Formatter

Attributi

CLSCompliantAttribute ObsoleteAttribute

Implementazioni

IFormatter

Commenti

Formatter è la abstract classe di base per tutti i formattatori di serializzazione di runtime e fornisce alcuni metodi helper per l'implementazione dell'interfaccia IFormatter . Gestisce Formatter anche gli oggetti di accodamento per la serializzazione e la generazione di ID in base a ogni oggetto.

Note per gli implementatori

Quando si eredita da Formatter, è necessario eseguire l'override dei membri seguenti:

• Serialize(Stream, Object)

• Deserialize(Stream)

• WriteArray(Object, String, Type)

• WriteBoolean(Boolean, String)

• WriteByte(Byte, String)

• WriteChar(Char, String)

• WriteDateTime(DateTime, String)

• WriteDecimal(Decimal, String)

• WriteDouble(Double, String)

• WriteInt16(Int16, String)

• WriteInt32(Int32, String)

• WriteInt64(Int64, String)

• WriteObjectRef(Object, String, Type)

• WriteSByte(SByte, String)

• WriteSingle(Single, String)

• WriteTimeSpan(TimeSpan, String)

• WriteUInt16(UInt16, String)

• WriteUInt32(UInt32, String)

• WriteUInt64(UInt64, String)

• WriteValueType(Object, String, Type)

• SurrogateSelector

• Binder

• Context

Costruttori

Formatter()

Obsoleti. Inizializza una nuova istanza della classe Formatter.

Campi

m_idGenerator	Obsoleti. Contiene il ObjectIDGenerator utilizzato con il formattatore corrente.
m_objectQueue	Obsoleti. Contiene un Queue degli oggetti ancora da serializzare.

Proprietà

Binder	Obsoleti. Quando si esegue l'override in una classe derivata, ottiene o imposta l'oggetto SerializationBinder utilizzato con il formattatore corrente.
Context	Obsoleti. Quando si esegue l'override in una classe derivata, recupera o imposta l'oggetto StreamingContext utilizzato per la serializzazione corrente.
SurrogateSelector	Obsoleti. Quando si esegue l'override in una classe derivata, ottiene o imposta l'oggetto ISurrogateSelector utilizzato con il formattatore corrente.

Metodi

Deserialize(Stream)	Quando si esegue l'override in una classe derivata, deserializza il flusso collegato al formattatore al momento della creazione, creando un grafico di oggetti identico a quello serializzato in origine in tale flusso.
Equals(Object)	Obsoleti. Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Obsoleti. Funge da funzione hash predefinita. (Ereditato da Object)
GetNext(Int64)	Obsoleti. Restituisce il successivo oggetto da serializzare dalla coda di lavoro interna del formattatore.
GetType()	Obsoleti. Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Obsoleti. Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Schedule(Object)	Obsoleti. Pianifica un oggetto per una successiva serializzazione.
Serialize(Stream, Object)	Quando si esegue l'override in una classe derivata, serializza il grafico di oggetti con l'elemento di primo livello specificato nel flusso già collegato al formattatore.
ToString()	Obsoleti. Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
WriteArray(Object, String, Type)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce una matrice nel flusso già collegato al formattatore.
WriteBoolean(Boolean, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un valore booleano nel flusso già collegato al formattatore.
WriteByte(Byte, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero senza segno a 8 bit nel flusso già collegato al formattatore.
WriteChar(Char, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un carattere Unicode nel flusso già collegato al formattatore.
WriteDateTime(DateTime, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un valore DateTime nel flusso già collegato al formattatore.
WriteDecimal(Decimal, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un valore Decimal nel flusso già collegato al formattatore.
WriteDouble(Double, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un numero in virgola mobile e precisione doppia nel flusso già collegato al formattatore.
WriteInt16(Int16, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero con segno a 16 bit nel flusso già collegato al formattatore.
WriteInt32(Int32, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero con segno a 32 bit nel flusso.
WriteInt64(Int64, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero con segno a 64 bit nel flusso.
WriteMember(String, Object)	Obsoleti. Controlla il tipo di dati ricevuti e chiama il metodo Write appropriato per eseguire la scrittura nel flusso già collegato al formattatore.
WriteObjectRef(Object, String, Type)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un riferimento a un oggetto nel flusso già collegato al formattatore.
WriteSByte(SByte, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero con segno a 8 bit nel flusso già collegato al formattatore.
WriteSingle(Single, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un numero in virgola mobile e precisione singola nel flusso già collegato al formattatore.
WriteTimeSpan(TimeSpan, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un valore TimeSpan nel flusso già collegato al formattatore.
WriteUInt16(UInt16, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero senza segno a 16 bit nel flusso già collegato al formattatore.
WriteUInt32(UInt32, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero senza segno a 32 bit nel flusso già collegato al formattatore.
WriteUInt64(UInt64, String)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un intero senza segno a 64 bit nel flusso già collegato al formattatore.
WriteValueType(Object, String, Type)	Obsoleti. Quando si esegue l'override in una classe derivata, inserisce un valore del tipo specificato nel flusso già collegato al formattatore.

Vedi anche

• ObjectIDGenerator
• Serializzazione XML e SOAP