Freigeben über

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 dieselbe 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 eine benutzerdefinierte ValueSerializer deklariert werden. Entweder sollte der ValueSerializer die Anforderungen erfüllen, oder dem Typ sollte ein NULL-Wert ValueSerializer zugeordnet sein. Ein ValueSerializer wird einem Typ zugeordnet, indem das ValueSerializerAttribute Attribut angewendet wird.

ValueSerializer Null gibt an, dass der Typkonverter für Konvertierungen aus dem Objektdiagramm ignoriert werden soll.

Wichtig

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

IValueSerializerContext für und ValueSerializer die zugehörigen APIs sind analog zu ITypeDescriptorContext einem TypeConverter. In der IValueSerializerContext Tat erbt ITypeDescriptorContext. Wenn eine abgeleitete ValueSerializer Klassen-API aufgerufen wird, übergibt der Aufrufer (in der Regel einen Serialisierungsprozess) einen Kontext, der möglicherweise bestimmte Dienste bereitstellt. Aufgrund der allgemeinen Anleitung ValueSerializer dürfen keine Ausnahmen ausgelöst werden. Fehler beim Zurückgeben eines bestimmten Diensts aus dem Kontext dürfen auch keine Ausnahmen auslösen.

In früheren Versionen des .NET Framework war diese Klasse in der WPF-spezifischen Assembly WindowsBase vorhanden. In .NET Framework 4 ValueSerializer befindet sich in der 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:

Weitere Informationen