Formatter Classe

Définition

Espace de noms:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Formatters.dll

Source:

Formatter.cs

Attention

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

Important

Cette API n’est pas conforme CLS.

Fournit la fonctionnalité de base pour les formateurs de sérialisation du 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

Héritage

Object

Formatter

Attributs

CLSCompliantAttribute ObsoleteAttribute

Implémente

IFormatter

Remarques

Formatter est la abstract classe de base pour tous les formateurs de sérialisation du runtime et fournit des méthodes d’assistance pour l’implémentation de l’interface IFormatter . Gère également la Formatter mise en file d’attente des objets pour la sérialisation et la génération d’ID par objet.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de Formatter, vous devez substituer les membres suivants :

• 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

Constructeurs

Formatter()

Obsolète. Initialise une nouvelle instance de la classe Formatter.

Champs

m_idGenerator	Obsolète. Contient le ObjectIDGenerator utilisé avec le formateur en cours.
m_objectQueue	Obsolète. Contient un Queue des objets à sérialiser restants.

Propriétés

Binder	Obsolète. En cas de substitution dans une classe dérivée, obtient ou définit le SerializationBinder utilisé avec le formateur en cours.
Context	Obsolète. En cas de substitution dans une classe dérivée, obtient ou définit le StreamingContext utilisé pour la sérialisation en cours.
SurrogateSelector	Obsolète. En cas de substitution dans une classe dérivée, obtient ou définit le ISurrogateSelector utilisé avec le formateur en cours.

Méthodes

Deserialize(Stream)	En cas de substitution dans une classe dérivée, désérialise le flux attaché au formateur quand il a été créé, en créant un graphique d'objets identique au graphique initialement sérialisé dans ce flux.
Equals(Object)	Obsolète. Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Obsolète. Fait office de fonction de hachage par défaut. (Hérité de Object)
GetNext(Int64)	Obsolète. Retourne l'objet à sérialiser suivant dans la file d'attente de travail interne du formateur.
GetType()	Obsolète. Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Obsolète. Crée une copie superficielle du Object actuel. (Hérité de Object)
Schedule(Object)	Obsolète. Planifie un objet pour sérialisation ultérieure.
Serialize(Stream, Object)	En cas de substitution dans une classe dérivée, sérialise le graphique d'objets avec la racine spécifiée dans le flux déjà attaché au formateur.
ToString()	Obsolète. Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
WriteArray(Object, String, Type)	Obsolète. En cas de substitution dans une classe dérivée, écrit un tableau dans le flux déjà attaché au formateur.
WriteBoolean(Boolean, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit une valeur booléenne dans le flux déjà attaché au formateur.
WriteByte(Byte, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier non signé 8 bits dans le flux déjà attaché au formateur.
WriteChar(Char, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un caractère Unicode dans le flux déjà attaché au formateur.
WriteDateTime(DateTime, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit une valeur DateTime dans le flux déjà attaché au formateur.
WriteDecimal(Decimal, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit une valeur Decimal dans le flux déjà attaché au formateur.
WriteDouble(Double, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un nombre à virgule flottante double précision dans le flux déjà attaché au formateur.
WriteInt16(Int16, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier signé 16 bits dans le flux déjà attaché au formateur.
WriteInt32(Int32, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier signé 32 bits dans le flux.
WriteInt64(Int64, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier 64 bits signé dans le flux.
WriteMember(String, Object)	Obsolète. Inspecte le type des données reçues et appelle la méthode Write appropriée pour exécuter l'écriture dans le flux déjà attaché au formateur.
WriteObjectRef(Object, String, Type)	Obsolète. En cas de substitution dans une classe dérivée, écrit une référence d'objet dans le flux déjà attaché au formateur.
WriteSByte(SByte, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier signé 8 bits dans le flux déjà attaché au formateur.
WriteSingle(Single, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un nombre à virgule flottante simple précision dans le flux déjà attaché au formateur.
WriteTimeSpan(TimeSpan, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit une valeur TimeSpan dans le flux déjà attaché au formateur.
WriteUInt16(UInt16, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier non signé 16 bits dans le flux déjà attaché au formateur.
WriteUInt32(UInt32, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier 32 bits non signé dans le flux déjà attaché au formateur.
WriteUInt64(UInt64, String)	Obsolète. En cas de substitution dans une classe dérivée, écrit un entier 64 bits non signé dans le flux déjà attaché au formateur.
WriteValueType(Object, String, Type)	Obsolète. En cas de substitution dans une classe dérivée, écrit la valeur du type donné dans le flux déjà attaché au formateur.

Voir aussi

• ObjectIDGenerator
• Sérialisation XML et SOAP