ComponentSerializationService.SerializeAbsolute Metoda
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í.
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
store
nebo value
je null
.
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í.