ValueSerializer Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Abstraktní třída, která definuje chování převodu serializace z reprezentace objektu.
public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
- Dědičnost
-
ValueSerializer
- Odvozené
Poznámky
Řetězec, který převaděč vrátí pro serializaci, musí být bez ztráty a převaděč musí vždy vrátit stejný řetězec pro určitou hodnotu. Pokud převaděč typu (odvozený z TypeConverter) nesplňuje tyto požadavky v jeho ConvertTo implementacích pro řetězcový výstup, musí být deklarován vlastní ValueSerializer .
ValueSerializer Buď by měla splňovat požadavky, nebo by měla být k typu přidružena hodnota nullValueSerializer. A ValueSerializer je přidružen k typu použitím atributu ValueSerializerAttribute .
Hodnota null ValueSerializer označuje, že převaděč typů by měl být ignorován pro převod převodu na řetězec z objektového grafu.
Important
ValueSerializer Implementace by se měla vyhnout vyvolání výjimek. Všechny vyvolané výjimky mohou ukončit serializaci.
IValueSerializerContext ValueSerializer pro a jeho rozhraní API je analogická ITypeDescriptorContext pro .TypeConverter Ve skutečnosti dědí IValueSerializerContextITypeDescriptorContext. ValueSerializer Při volání rozhraní API odvozené třídy volající (obvykle proces serializátoru) předává kontext, který může poskytovat určité služby. Vzhledem k obecným pokynům ValueSerializer , které nesmí vyvolat výjimky. Selhání vrácení konkrétní služby z kontextu nesmí také vyvolat žádné výjimky.
V předchozích verzích rozhraní .NET Framework existovala tato třída v sestavení wpF specifickém pro WindowsBase. V rozhraní .NET Framework 4 ValueSerializer je v sestavení System.Xaml. Další informace naleznete v tématu Typy migrované z WPF (Windows Presentation Foundation) do System.Xaml.
Konstruktory
| Name | Description |
|---|---|
| ValueSerializer() |
Inicializuje novou instanci ValueSerializer třídy. |
Metody
| Name | Description |
|---|---|
| CanConvertFromString(String, IValueSerializerContext) |
Při přepsání v odvozené třídě určuje, zda zadané String lze převést na instanci typu, který implementace ValueSerializer podporuje. |
| CanConvertToString(Object, IValueSerializerContext) |
Při přepsání v odvozené třídě určuje, zda zadaný objekt lze převést na String. |
| ConvertFromString(String, IValueSerializerContext) |
Při přepsání v odvozené třídě převede String na instanci typu, který implementace ValueSerializer podporuje. |
| ConvertToString(Object, IValueSerializerContext) |
Při přepsání v odvozené třídě převede zadaný objekt na .String |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetConvertFromException(Object) |
Vrátí výjimku, která se vyvolá, když převod nelze provést. |
| GetConvertToException(Object, Type) |
Vrátí výjimku, která se vyvolá, když převod nelze provést. |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetSerializerFor(PropertyDescriptor, IValueSerializerContext) |
ValueSerializer Získá deklarovanou pro zadanou vlastnost pomocí zadaného kontextu. |
| GetSerializerFor(PropertyDescriptor) |
ValueSerializer Získá deklarovanou pro vlastnost předáním popisovače vlastnosti CLR pro vlastnost. |
| GetSerializerFor(Type, IValueSerializerContext) |
ValueSerializer Získá deklarovaný pro zadaný typ pomocí zadaného kontextu. |
| GetSerializerFor(Type) |
ValueSerializer Získá deklarovaný pro zadaný typ. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TypeReferences(Object, IValueSerializerContext) |
Získá výčet typů, na které ValueSerializerodkazuje . |