Partage via


ValueSerializer Classe

Définition

Classe abstraite qui définit le comportement de conversion pour la sérialisation à partir d’une représentation sous forme d’objet.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
Héritage
ValueSerializer
Dérivé

Remarques

La chaîne retournée par un convertisseur pour la sérialisation doit être sans perte et le convertisseur doit toujours retourner la même chaîne pour une valeur particulière. Si un convertisseur de type (dérivé de TypeConverter) ne répond pas à ces exigences dans ses ConvertTo implémentations pour la sortie de chaîne, un personnalisé ValueSerializer doit être déclaré. Soit le ValueSerializer doit répondre aux exigences, soit une valeur null ValueSerializer doit être associée au type. Un ValueSerializer est associé à un type en appliquant l’attribut ValueSerializerAttribute .

Une valeur null ValueSerializer indique que le convertisseur de type doit être ignoré pour les conversions de conversion en chaîne à partir du graphique d’objets.

Important

L’implémentation de ValueSerializer doit éviter de lever des exceptions. Toutes les exceptions levées peuvent mettre fin à la sérialisation.

IValueSerializerContext ValueSerializer et ses API sont analogues à ITypeDescriptorContext pour un TypeConverter. En fait, IValueSerializerContext hérite de ITypeDescriptorContext. Lorsqu’une ValueSerializer API de classe dérivée est appelée, l’appelant (généralement un processus de sérialiseur) transmet un contexte qui peut fournir certains services. En raison des instructions générales qui indiquent qu’un ne doit pas lever d’exceptions ValueSerializer . L’échec du retour d’un service particulier à partir du contexte ne doit pas non plus lever d’exceptions.

Dans les versions précédentes du .NET Framework, cette classe existait dans l’assembly WindowsBase spécifique à WPF. Dans .NET Framework 4, ValueSerializer se trouve dans l’assembly System.Xaml. Pour plus d'informations, consultez Types Migrated from WPF to System.Xaml.

Constructeurs

ValueSerializer()

Initialise une nouvelle instance de la classe ValueSerializer.

Méthodes

CanConvertFromString(String, IValueSerializerContext)

En cas de substitution dans une classe dérivée, détermine si le String spécifié peut être converti en instance du type que l’implémentation de ValueSerializer prend en charge.

CanConvertToString(Object, IValueSerializerContext)

En cas de remplacement dans une classe dérivée, détermine si l’objet spécifié peut être converti en String.

ConvertFromString(String, IValueSerializerContext)

En cas de substitution dans une classe dérivée, convertit un String en une instance du type que l’implémentation de ValueSerializer prend en charge.

ConvertToString(Object, IValueSerializerContext)

En cas de substitution dans une classe dérivée, convertit l’objet spécifié en String.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetConvertFromException(Object)

Retourne une exception à lever quand une conversion ne peut pas être effectuée.

GetConvertToException(Object, Type)

Retourne une exception à lever quand une conversion ne peut pas être effectuée.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetSerializerFor(PropertyDescriptor)

Obtient le ValueSerializer déclaré pour une propriété, en passant un descripteur de propriété CLR pour la propriété.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Obtient le ValueSerializer déclaré pour la propriété spécifiée en utilisant le contexte spécifié.

GetSerializerFor(Type)

Obtient le ValueSerializer déclaré pour le type spécifié.

GetSerializerFor(Type, IValueSerializerContext)

Obtient le ValueSerializer déclaré pour le type spécifié, à l’aide du contexte spécifié.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TypeReferences(Object, IValueSerializerContext)

Obtient une énumération des types référencés par ValueSerializer.

S’applique à

Voir aussi