ComponentSerializationService.SerializeAbsolute Metoda

Definice

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í.

Platí pro

Viz také