ValueSerializer Klasse

  • Referenz

Definition

Namespace:
System.Windows.Markup
Assembly:
WindowsBase.dll
Assembly:
System.Xaml.dll

Abstrakte Klasse, die das Konvertierungsverhalten für die Serialisierung aus einer Objektdarstellung definiert.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
Vererbung
Object
ValueSerializer
Abgeleitet

Hinweise

Die Zeichenfolge, die ein Konverter für die Serialisierung zurückgibt, muss verlustfrei sein, und der Konverter muss immer die gleiche Zeichenfolge für einen bestimmten Wert zurückgeben. Wenn ein Typkonverter (abgeleitet von TypeConverter) diese Anforderungen in seinen ConvertTo Implementierungen für die Zeichenfolgenausgabe nicht erfüllt, muss ein Benutzerdefinierter ValueSerializer deklariert werden. Entweder sollte ValueSerializer die Anforderungen erfüllt werden, oder eine Null ValueSerializer sollte dem Typ zugeordnet werden. A ValueSerializer ist einem Typ zugeordnet, indem das ValueSerializerAttribute Attribut angewendet wird.

Eine Null ValueSerializer gibt an, dass der Typkonverter für Konvertierungs-in-Zeichenfolgenkonvertierungen aus dem Objektdiagramm ignoriert werden soll.

Wichtig

Die Implementierung sollte das Auslösen von ValueSerializer Ausnahmen vermeiden. Ausnahmen können die Serialisierung beenden.

IValueSerializerContext für eine ValueSerializer und seine APIs ist analog zu ITypeDescriptorContext einer TypeConverter. In der Tat IValueSerializerContext erbt ITypeDescriptorContext. Wenn eine ValueSerializer abgeleitete Klassen-API aufgerufen wird, übergibt der Aufrufer (normalerweise ein Serializerprozess) einen Kontext, der bestimmte Dienste bereitstellen kann. Aufgrund der allgemeinen Anleitungen, dass eine ValueSerializer Ausnahme nicht ausgelöst werden darf. Fehler beim Zurückgeben eines bestimmten Diensts aus dem Kontext darf auch keine Ausnahmen auslösen.

In früheren Versionen der .NET Framework ist diese Klasse in der WPF-spezifischen Assembly WindowsBase vorhanden. In .NET Framework 4 ValueSerializer befindet sich die System.Xaml-Assembly. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.

Konstruktoren

ValueSerializer()

Initialisiert eine neue Instanz der ValueSerializer-Klasse.

Methoden

CanConvertFromString(String, IValueSerializerContext)

Bestimmt beim Überschreiben in einer abgeleiteten Klasse, ob die angegebene String in eine Instanz des Typs konvertiert werden kann, den die Implementierung von ValueSerializer unterstützt.
CanConvertToString(Object, IValueSerializerContext)

Bestimmt beim Überschreiben in einer abgeleiteten Klasse, ob das angegebene Objekt in eine String konvertiert werden kann.
ConvertFromString(String, IValueSerializerContext)

Konvertiert beim Überschreiben in einer abgeleiteten Klasse eine String in eine Instanz des Typs, den die Implementierung von ValueSerializer unterstützt.
ConvertToString(Object, IValueSerializerContext)

Konvertiert das angegebene Objekt beim Überschreiben in einer abgeleiteten Klasse in eine String.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetConvertFromException(Object)

Gibt eine Ausnahme zurück, wenn eine Konvertierung nicht erfolgen kann.
GetConvertToException(Object, Type)

Gibt eine Ausnahme zurück, wenn eine Konvertierung nicht erfolgen kann.
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetSerializerFor(PropertyDescriptor)

Ruft den ValueSerializer ab, der für eine Eigenschaft deklariert ist, indem ein CLR-Eigenschaftendeskriptor für die Eigenschaft übergeben wird.
GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Ruft mit dem angegebenen Kontext den ValueSerializer ab, der für die angegebene Eigenschaft deklariert ist.
GetSerializerFor(Type)

Ruft den ValueSerializer ab, der für den angegebenen Typ deklariert wurde.
GetSerializerFor(Type, IValueSerializerContext)

Ruft mit dem angegebenen Kontext den ValueSerializer ab, der für den angegebenen Typ deklariert ist.
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TypeReferences(Object, IValueSerializerContext)

Ruft eine Enumeration der Typen auf, auf die ValueSerializer verweist.

Gilt für:

Siehe auch