ValueSerializer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Classe abstraite qui définit le comportement de conversion pour la sérialisation à partir d’une représentation d’objet.
public ref class ValueSerializer abstractpublic abstract class ValueSerializertype ValueSerializer = classPublic 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, une personnalisée ValueSerializer doit être déclarée. Soit le ValueSerializer doit répondre aux exigences, soit une valeur Null ValueSerializer doit être associée au type. A 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 graphe 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 pour a ValueSerializer et ses API sont analogues à ITypeDescriptorContext un TypeConverter. En fait, IValueSerializerContext hérite 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 conseils généraux qu’un ValueSerializer ne doit pas lever d’exceptions. L’échec de 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 migrés de WPF vers System.Xaml.
Constructeurs
| Nom | Description |
|---|---|
| ValueSerializer() |
Initialise une nouvelle instance de la classe ValueSerializer. |
Méthodes
| Nom | Description |
|---|---|
| CanConvertFromString(String, IValueSerializerContext) |
En cas de substitution dans une classe dérivée, détermine si le spécifié String peut être converti en instance du type pris en charge par l’implémentation.ValueSerializer |
| CanConvertToString(Object, IValueSerializerContext) |
En cas de substitution dans une classe dérivée, détermine si l’objet spécifié peut être converti en un String. |
| ConvertFromString(String, IValueSerializerContext) |
En cas de substitution dans une classe dérivée, convertit une String instance du type pris en charge par l’implémentation.ValueSerializer |
| ConvertToString(Object, IValueSerializerContext) |
En cas de substitution dans une classe dérivée, convertit l’objet spécifié en un 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 lorsqu’une conversion ne peut pas être effectuée. |
| GetConvertToException(Object, Type) |
Retourne une exception à lever lorsqu’une conversion ne peut pas être effectuée. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetSerializerFor(PropertyDescriptor, IValueSerializerContext) |
Obtient la ValueSerializer valeur déclarée pour la propriété spécifiée, à l’aide du contexte spécifié. |
| GetSerializerFor(PropertyDescriptor) |
Obtient la ValueSerializer valeur déclarée pour une propriété, en passant un descripteur de propriété CLR pour la propriété. |
| GetSerializerFor(Type, IValueSerializerContext) |
Obtient le ValueSerializer type déclaré pour le type spécifié, à l’aide du contexte spécifié. |
| GetSerializerFor(Type) |
Obtient le ValueSerializer type déclaré pour le type spécifié. |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (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 le ValueSerializer. |