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, účetní 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
Stav SerializationStore , do kterého value bude serializován.
- value
- Object
Objekt, který se má serializovat.
Výjimky
store nebo value je null.
store je zavřený nebo store není podporovaným typem úložiště serializace. Použít úložiště vrácené CreateStore().
Poznámky
Standardní serializace, jak je implementována prostřednictvím Serialize metody, pouze serializuje hodnoty, které se liší od výchozího stavu komponenty. To poskytuje nejkomprimovanější serializační mechanismus, ale předpokládá, že se při deserializaci použije nově vytvořený objekt. Pokud se použije existující objekt, výsledný deserializovaný objekt není zaručen duplikovat původní stav serializovaného objektu; vlastnosti, které obsahovaly výchozí hodnoty během serializace, nebudou při deserializaci obnoveny zpět na jejich výchozí hodnoty.
Tato SerializeAbsolute metoda nepoužívá tuto klávesovou zkratku. Serializuje všechny vlastnosti zdrojového objektu tak, aby deserializace mohl 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. V této situaci je nejbezpečnějším procesem obnovení původního stavu celé kolekce přepsat všechny položky se všemi jejich původními hodnotami vlastností.