ComponentSerializationService.SerializeAbsolute Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Serializuje dany obiekt, co odpowiada domyślnym wartościom właściwości.
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 -> unitPublic MustOverride Sub SerializeAbsolute (store As SerializationStore, value As Object)Parametry
- store
- SerializationStore
Do SerializationStore którego stan value będzie serializowany.
- value
- Object
Obiekt do serializacji.
Wyjątki
store lub value to null.
store jest zamknięty lub store nie jest obsługiwanym typem magazynu serializacji. Użyj magazynu zwróconego przez CreateStore().
Uwagi
Serializacji standardowej, zgodnie z implementacją Serialize metody, serializuje tylko wartości, które różnią się od domyślnego stanu składnika. Zapewnia to najbardziej kompaktowy mechanizm serializacji, ale zakłada, że nowo utworzony obiekt będzie używany podczas deserializacji. Jeśli jest używany istniejący obiekt, wynikowy deserializowany obiekt nie ma gwarancji zduplikowania oryginalnego stanu obiektu serializowanego; właściwości, które zawierały wartości domyślne podczas serializacji, nie zostaną zresetowane do wartości domyślnych podczas deserializacji.
Metoda SerializeAbsolute nie używa tego skrótu. Serializuje wszystkie właściwości obiektu źródłowego, aby deserializacja mogła przywrócić wszystkie właściwości obiektu, niezależnie od stanu domyślnego.
Ta metoda jest szczególnie przydatna do serializacji kolekcji, ponieważ kolejność elementów składowych w kolekcji może ulec zmianie. W takim przypadku najbezpieczniejszym procesem przywrócenia oryginalnego stanu całej kolekcji jest zastąpienie wszystkich elementów wszystkimi ich oryginalnymi wartościami właściwości.
