ComponentSerializationService.SerializeAbsolute Metoda

Definice

Obor názvů:

System.ComponentModel.Design.Serialization

Sestavení:

System.ComponentModel.TypeConverter.dll

Zdroj:

ComponentSerializationService.cs

Serializuje daný objekt a započítá se do výchozích hodnot vlastností.

public:
 abstract void SerializeAbsolute(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::Object ^ value);

public abstract void SerializeAbsolute (System.ComponentModel.Design.Serialization.SerializationStore store, object value);

abstract member SerializeAbsolute : System.ComponentModel.Design.Serialization.SerializationStore * obj -> unit

Public MustOverride Sub SerializeAbsolute (store As SerializationStore, value As Object)

Parametry

store

SerializationStore

Hodnota SerializationStore , do které bude stav value serializován.

value

Object

Objekt serializovat.

Výjimky

ArgumentNullException

store nebo value je null.

InvalidOperationException

store je zavřený nebo store není podporovaným typem úložiště serializace. Použijte úložiště vrácené nástrojem CreateStore().

Poznámky

Standardní serializace, jak je implementováno prostřednictvím Serialize metody, serializuje pouze hodnoty, které se liší od výchozího stavu komponenty. To poskytuje nejkompaktnější serializace mechanismus, ale předpokládá, že nově vytvořený objekt bude použit během deserializace. Pokud existující objekt je použit, výsledný deserializovaný objekt není zaručeno duplikovat původní stav serializovaného objektu; vlastnosti, které obsahovaly výchozí hodnoty během serializace nebudou obnoveny jejich výchozí hodnoty během deserializace.

Metoda SerializeAbsolute tuto zkratku nepoužívá. Serializuje všechny vlastnosti zdrojového objektu tak, aby deserializace může obnovit všechny vlastnosti objektu bez ohledu na výchozí stav.

Tato metoda je zvláště užitečná pro serializaci kolekcí, protože pořadí základních položek v kolekci se může změnit. Za těchto okolností je nejbezpečnějším procesem obnovení původního stavu celé kolekce přepsání všech položek všemi jejich původními hodnotami vlastností.

Viz také

• SerializationStore
• MemberDescriptor
• Serialize(SerializationStore, Object)
• SerializeMember(SerializationStore, Object, MemberDescriptor)
• SerializeMemberAbsolute(SerializationStore, Object, MemberDescriptor)