ValueSerializer ValueSerializer ValueSerializer ValueSerializer Class

Definition

Abstrakte Klasse, die Konvertierungsverhalten für die Serialisierung von einer Objektdarstellung definiert.Abstract class that defines conversion behavior for serialization from an object representation.

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

Hinweise

Die Zeichenfolge, die ein Konverter für die Serialisierung zurückgibt, muss weniger Verlust sein, und der Konverter muss immer dieselbe Zeichenfolge für einen bestimmten Wert zurückgeben.The string a converter returns for serialization must be loss-less and the converter must always return the same string for a particular value. Wenn ein Typkonverter (abgeleitet von TypeConverter) diese Anforderungen in seinen Implementierungen für die ConvertTo Zeichen folgen Ausgabe nicht erfüllt, muss ValueSerializer ein benutzerdefinierter deklariert werden.If a type converter (derived from TypeConverter) does not meet these requirements in its ConvertTo implementations for string output, a custom ValueSerializer must be declared. Der muss die Anforderungen erfüllen, oder dem Typ muss ValueSerializer ein NULL-Wert zugeordnet werden. ValueSerializerEither the ValueSerializer should meet the requirements, or a null ValueSerializer should be associated with the type. Ein ValueSerializer wird einem Typ durch Anwenden des ValueSerializerAttribute -Attributs zugeordnet.A ValueSerializer is associated with a type by applying the ValueSerializerAttribute attribute.

Ein NULL ValueSerializer -Wert gibt an, dass der Typkonverter für Konvertierungen von Konvertierungen aus dem Objekt Diagramm ignoriert werden soll.A null ValueSerializer indicates the type converter should be ignored for convert-to-string conversions from the object graph.

Wichtig

Die Implementierung ValueSerializer von sollte das Auslösen von Ausnahmen vermeiden.Implementation of ValueSerializer should avoid throwing exceptions. Alle ausgelösten Ausnahmen könnten die Serialisierung beenden.Any exceptions thrown could terminate serialization.

IValueSerializerContextfür eine ValueSerializer und ihre APIs ist analog zu ITypeDescriptorContext für eine TypeConverter.IValueSerializerContext for a ValueSerializer and its APIs is analogous to ITypeDescriptorContext for a TypeConverter. Tatsächlich IValueSerializerContext erbt ITypeDescriptorContext.In fact, IValueSerializerContext inherits ITypeDescriptorContext. Wenn eine ValueSerializer abgeleitete Klassen-API aufgerufen wird, übergibt der Aufrufer (in der Regel ein Serialisierungsprozess) einen Kontext, der möglicherweise bestimmte Dienste bereitstellt.When a ValueSerializer derived class API is called, the caller (typically a serializer process) passes a context that may provide certain services. Aufgrund der allgemeinen Anleitung, dass ein ValueSerializer keine Ausnahmen auslösen darf.Because of the general guidance that a ValueSerializer must not throw exceptions. Wenn ein bestimmter Dienst nicht aus dem Kontext zurückgegeben wird, müssen auch keine Ausnahmen ausgelöst werden.Failure to return a particular service from the context must also not throw any exceptions.

In früheren Versionen des .NET Framework war diese Klasse in der WPF-spezifischen Assembly Windows Base vorhanden.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. In .NET Framework 4.NET Framework 4befindetsichin derSystem.XAML-Assembly.ValueSerializerIn .NET Framework 4.NET Framework 4, ValueSerializer is in the System.Xaml assembly. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.For more information, see Types Migrated from WPF to System.Xaml.

Konstruktoren

ValueSerializer() ValueSerializer() ValueSerializer() ValueSerializer()

Initialisiert eine neue Instanz der ValueSerializer-Klasse.Initializes a new instance of the ValueSerializer class.

Methoden

CanConvertFromString(String, IValueSerializerContext) CanConvertFromString(String, IValueSerializerContext) CanConvertFromString(String, IValueSerializerContext) 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.When overridden in a derived class, determines whether the specified String can be converted to an instance of the type that the implementation of ValueSerializer supports.

CanConvertToString(Object, IValueSerializerContext) CanConvertToString(Object, IValueSerializerContext) CanConvertToString(Object, IValueSerializerContext) CanConvertToString(Object, IValueSerializerContext)

Bestimmt beim Überschreiben in einer abgeleiteten Klasse, ob das angegebene Objekt in eine String konvertiert werden kann.When overridden in a derived class, determines whether the specified object can be converted into a String.

ConvertFromString(String, IValueSerializerContext) ConvertFromString(String, IValueSerializerContext) ConvertFromString(String, IValueSerializerContext) ConvertFromString(String, IValueSerializerContext)

Konvertiert beim Überschreiben in einer abgeleiteten Klasse eine String in eine Instanz des Typs, den die Implementierung von ValueSerializer unterstützt.When overridden in a derived class, converts a String to an instance of the type that the implementation of ValueSerializer supports.

ConvertToString(Object, IValueSerializerContext) ConvertToString(Object, IValueSerializerContext) ConvertToString(Object, IValueSerializerContext) ConvertToString(Object, IValueSerializerContext)

Konvertiert das angegebene Objekt beim Überschreiben in einer abgeleiteten Klasse in eine String.When overridden in a derived class, converts the specified object to a String.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetConvertFromException(Object) GetConvertFromException(Object) GetConvertFromException(Object) GetConvertFromException(Object)

Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht durchgeführt werden kann.Returns an exception to throw when a conversion cannot be performed.

GetConvertToException(Object, Type) GetConvertToException(Object, Type) GetConvertToException(Object, Type) GetConvertToException(Object, Type)

Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht durchgeführt werden kann.Returns an exception to throw when a conversion cannot be performed.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetSerializerFor(PropertyDescriptor) GetSerializerFor(PropertyDescriptor) GetSerializerFor(PropertyDescriptor) GetSerializerFor(PropertyDescriptor)

Ruft den ValueSerializer ab, der für eine Eigenschaft deklariert wurde, indem ein CLR-Eigenschaftendeskriptor für die Eigenschaft übergeben wird.Gets the ValueSerializer declared for a property, by passing a CLR property descriptor for the property.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext) GetSerializerFor(PropertyDescriptor, IValueSerializerContext) GetSerializerFor(PropertyDescriptor, IValueSerializerContext) GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Ruft im angegebenen Kontext den für die angegebene Eigenschaft deklarierten ValueSerializer ab.Gets the ValueSerializer declared for the specified property, using the specified context.

GetSerializerFor(Type) GetSerializerFor(Type) GetSerializerFor(Type) GetSerializerFor(Type)

Ruft den für den angegebenen Typ deklarierten ValueSerializer ab.Gets the ValueSerializer declared for the specified type.

GetSerializerFor(Type, IValueSerializerContext) GetSerializerFor(Type, IValueSerializerContext) GetSerializerFor(Type, IValueSerializerContext) GetSerializerFor(Type, IValueSerializerContext)

Ruft im angegebenen Kontext den für den angegebenen Typ deklarierten ValueSerializer ab.Gets the ValueSerializer declared for the specified type, using the specified context.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TypeReferences(Object, IValueSerializerContext) TypeReferences(Object, IValueSerializerContext) TypeReferences(Object, IValueSerializerContext) TypeReferences(Object, IValueSerializerContext)

Ruft eine Enumeration der vom ValueSerializer referenzierten Typen ab.Gets an enumeration of the types referenced by the ValueSerializer.

Gilt für:

Siehe auch