Share via

ComponentSerializationService.SerializeAbsolute Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.ComponentModel.Design.Serialization
Zestaw:
System.ComponentModel.TypeConverter.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
ComponentSerializationService.cs
Źródło:
ComponentSerializationService.cs
Źródło:
ComponentSerializationService.cs

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 -> unit
Public 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

ArgumentNullException

store lub value to null.

InvalidOperationException

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.

Dotyczy

Zobacz też