ValueSerializer Klass

Definition

Namnområde:
System.Windows.Markup
Sammansättning:
WindowsBase.dll
Sammansättning:
System.Xaml.dll

Abstrakt klass som definierar konverteringsbeteende för serialisering från en objektrepresentation.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
Arv
Object
ValueSerializer
Härledda

Kommentarer

Strängen som konverteraren returnerar för serialisering måste vara förlustfri och konverteraren måste alltid returnera samma sträng för ett visst värde. Om en typkonverterare (härledd från TypeConverter) inte uppfyller dessa krav i implementeringarna ConvertTo för strängutdata måste en anpassad ValueSerializer deklareras. ValueSerializer Antingen ska uppfylla kraven, eller så ska en null ValueSerializer associeras med typen. A ValueSerializer associeras med en typ genom att använda attributet ValueSerializerAttribute .

En null ValueSerializer anger att typkonverteraren ska ignoreras för konverteringar av konvertera till strängar från objektdiagrammet.

Important

Implementering av ValueSerializer bör undvika att utlösa undantag. Eventuella undantag som utlöses kan avsluta serialiseringen.

IValueSerializerContext för a ValueSerializer och dess API:er är analoga med ITypeDescriptorContext för en TypeConverter. I själva verket IValueSerializerContext ärver ITypeDescriptorContext. När ett ValueSerializer API för härledd klass anropas skickar anroparen (vanligtvis en serialiserarprocess) en kontext som kan tillhandahålla vissa tjänster. På grund av den allmänna vägledningen att en ValueSerializer inte får utlösa undantag. Det går inte att returnera en viss tjänst från kontexten får inte heller utlösa några undantag.

I tidigare versioner av .NET Framework fanns den här klassen i den WPF specifika sammansättningen WindowsBase. I .NET Framework 4 finns ValueSerializer i System.Xaml-sammansättningen. Mer information finns i Types Migrerad från WPF till System.Xaml.

Konstruktorer

Name Description
ValueSerializer()

Initierar en ny instans av ValueSerializer klassen.

Metoder

Name Description
CanConvertFromString(String, IValueSerializerContext)

När den åsidosätts i en härledd klass avgör du om den angivna String kan konverteras till en instans av den typ som implementeringen av ValueSerializer stöder.
CanConvertToString(Object, IValueSerializerContext)

När det åsidosättas i en härledd klass avgör om det angivna objektet kan konverteras till en String.
ConvertFromString(String, IValueSerializerContext)

När den åsidosätts i en härledd klass konverteras en String till en instans av den typ som implementeringen av ValueSerializer stöder.
ConvertToString(Object, IValueSerializerContext)

När det åsidosättas i en härledd klass konverterar det angivna objektet till en String.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetConvertFromException(Object)

Returnerar ett undantag som ska utlösas när en konvertering inte kan utföras.
GetConvertToException(Object, Type)

Returnerar ett undantag som ska utlösas när en konvertering inte kan utföras.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Hämtar den ValueSerializer deklarerade för den angivna egenskapen med hjälp av den angivna kontexten.
GetSerializerFor(PropertyDescriptor)

Hämtar den ValueSerializer deklarerade för en egenskap genom att skicka en CLR-egenskapsbeskrivning för egenskapen.
GetSerializerFor(Type, IValueSerializerContext)

Hämtar den ValueSerializer deklarerade för den angivna typen med hjälp av den angivna kontexten.
GetSerializerFor(Type)

Hämtar den ValueSerializer deklarerade för den angivna typen.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TypeReferences(Object, IValueSerializerContext)

Hämtar en uppräkning av de typer som refereras av ValueSerializer.

Gäller för

Se även