ValueSerializer Klasa

Definicja

Klasa abstrakcyjna, która definiuje zachowanie konwersji na potrzeby serializacji z reprezentacji obiektu.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
Dziedziczenie
ValueSerializer
Pochodne

Uwagi

Ciąg zwracany przez konwerter dla serializacji musi być bez utraty, a konwerter musi zawsze zwracać ten sam ciąg dla określonej wartości. Jeśli konwerter typów (pochodzący z TypeConverterklasy ) nie spełnia tych wymagań w implementacjach ConvertTo dla danych wyjściowych ciągu, należy zadeklarować niestandardowy ValueSerializer . ValueSerializer Element powinien spełniać wymagania lub wartość null ValueSerializer powinna być skojarzona z typem. Element ValueSerializer jest skojarzony z typem przez zastosowanie atrybutu ValueSerializerAttribute .

Wartość null ValueSerializer wskazuje, że konwerter typów powinien być ignorowany w przypadku konwersji typu na ciąg z grafu obiektu.

Ważne

Implementacja programu powinna unikać zgłaszania ValueSerializer wyjątków. Wszelkie zgłoszone wyjątki mogą zakończyć serializacji.

IValueSerializerContext dla obiektu ValueSerializer i jego interfejsy API są analogiczne do ITypeDescriptorContext interfejsu TypeConverter. W rzeczywistości IValueSerializerContext dziedziczy wartość ITypeDescriptorContext. ValueSerializer Gdy wywoływany jest interfejs API klasy pochodnej, obiekt wywołujący (zazwyczaj proces serializatora) przekazuje kontekst, który może świadczyć określone usługi. Ze względu na ogólne wskazówki, które ValueSerializer nie mogą zgłaszać wyjątków. Nie można zwrócić określonej usługi z kontekstu nie może również zgłaszać żadnych wyjątków.

W poprzednich wersjach .NET Framework ta klasa istniała w bazie WindowsBase zestawu specyficznego dla platformy WPF. W .NET Framework 4 ValueSerializer znajduje się w zestawie System.Xaml. Aby uzyskać więcej informacji, zobacz Typy migrowane z WPF do System.Xaml.

Konstruktory

ValueSerializer()

Inicjuje nowe wystąpienie klasy ValueSerializer.

Metody

CanConvertFromString(String, IValueSerializerContext)

Po przesłonięciu w klasie pochodnej określa, czy określony String można przekonwertować na wystąpienie typu obsługiwanego przez ValueSerializer implementację.

CanConvertToString(Object, IValueSerializerContext)

Podczas zastępowania w klasie pochodnej określa, czy określony obiekt można przekonwertować na String.

ConvertFromString(String, IValueSerializerContext)

Po przesłonięcia w klasie pochodnej konwertuje String klasę na wystąpienie typu obsługiwanego przez ValueSerializer implementację.

ConvertToString(Object, IValueSerializerContext)

Podczas zastępowania w klasie pochodnej konwertuje określony obiekt na String.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetConvertFromException(Object)

Zwraca wyjątek zgłaszany, gdy nie można wykonać konwersji.

GetConvertToException(Object, Type)

Zwraca wyjątek zgłaszany, gdy nie można wykonać konwersji.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetSerializerFor(PropertyDescriptor)

ValueSerializer Pobiera zadeklarowany dla właściwości przez przekazanie deskryptora właściwości CLR dla właściwości.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Pobiera zadeklarowane ValueSerializer dla określonej właściwości przy użyciu określonego kontekstu.

GetSerializerFor(Type)

Pobiera zadeklarowany ValueSerializer dla określonego typu.

GetSerializerFor(Type, IValueSerializerContext)

Pobiera zadeklarowany ValueSerializer dla określonego typu przy użyciu określonego kontekstu.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
TypeReferences(Object, IValueSerializerContext)

Pobiera wyliczenie typów, do których odwołuje się element ValueSerializer.

Dotyczy

Zobacz też