ValueSerializer Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Markup
Assembly:
WindowsBase.dll
Assembly:
System.Xaml.dll

Classe astratta che definisce il comportamento di conversione per la serializzazione da una rappresentazione di oggetto.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
Ereditarietà
Object
ValueSerializer
Derivato

Commenti

La stringa restituita da un convertitore per la serializzazione deve essere meno perdita e il convertitore deve sempre restituire la stessa stringa per un determinato valore. Se un convertitore di tipi (derivato da TypeConverter) non soddisfa questi requisiti nelle ConvertTo relative implementazioni per l'output stringa, è necessario dichiarare un oggetto personalizzato ValueSerializer . L'oggetto ValueSerializer deve soddisfare i requisiti o un valore Null ValueSerializer deve essere associato al tipo. A ValueSerializer è associato a un tipo applicando l'attributo ValueSerializerAttribute .

Un valore Null ValueSerializer indica che il convertitore di tipi deve essere ignorato per le conversioni convert-to-string dal grafico dell'oggetto.

Importante

L'implementazione di deve evitare di ValueSerializer generare eccezioni. Eventuali eccezioni generate potrebbero terminare la serializzazione.

IValueSerializerContext per un ValueSerializer oggetto e le relative API è analogo a ITypeDescriptorContext per un TypeConverteroggetto . Di fatto eredita IValueSerializerContextITypeDescriptorContext. Quando viene chiamata un'API di classe derivata, il chiamante (in genere un ValueSerializer processo serializzatore) passa un contesto che può fornire determinati servizi. A causa delle indicazioni generali che un ValueSerializer non deve generare eccezioni. L'errore di restituire un servizio specifico dal contesto non deve anche generare eccezioni.

Nelle versioni precedenti di .NET Framework, questa classe esiste nell'assembly specifico di WPF WindowsBase. In .NET Framework 4 ValueSerializer si trova nell'assembly System.Xaml. Per altre informazioni, vedere Types Migrated from WPF to System.Xaml.

Costruttori

ValueSerializer()

Inizializza una nuova istanza della classe ValueSerializer.

Metodi

CanConvertFromString(String, IValueSerializerContext)

In caso di override in una classe derivata, determina se l'oggetto String specificato può essere convertito in un'istanza del tipo supportato dall'implementazione di ValueSerializer.
CanConvertToString(Object, IValueSerializerContext)

In caso di override in una classe derivata, determina se l'oggetto specificato può essere convertito in un oggetto String.
ConvertFromString(String, IValueSerializerContext)

In caso di override in una classe derivata, converte un oggetto String in un'istanza del tipo che l'implementazione di ValueSerializer supporta.
ConvertToString(Object, IValueSerializerContext)

In caso di override in una classe derivata, converte l'oggetto specificato in un oggetto String.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetConvertFromException(Object)

Restituisce un'eccezione da generare quando non è possibile eseguire una conversione.
GetConvertToException(Object, Type)

Restituisce un'eccezione da generare quando non è possibile eseguire una conversione.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetSerializerFor(PropertyDescriptor)

Ottiene l'oggetto ValueSerializer dichiarato per una proprietà, passando un descrittore di proprietà CLR per la proprietà.
GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Ottiene l'oggetto ValueSerializer dichiarato per la proprietà specificata, usando il contesto specificato.
GetSerializerFor(Type)

Ottiene l'oggetto ValueSerializer dichiarato per il tipo specificato.
GetSerializerFor(Type, IValueSerializerContext)

Ottiene l'oggetto ValueSerializer dichiarato per il tipo specificato, usando il contesto specificato.
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)
TypeReferences(Object, IValueSerializerContext)

Ottiene un'enumerazione dei tipi a cui fa riferimento l'oggetto ValueSerializer.

Si applica a

Vedi anche