ComponentSerializationService.SerializeAbsolute Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Serializza l'oggetto specificato, tenendo conto dei valori predefiniti delle proprietà.
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)Parametri
- store
- SerializationStore
Oggetto SerializationStore a cui verrà serializzato lo stato di value .
- value
- Object
Oggetto da serializzare.
Eccezioni
store o value è null.
store è chiuso o store non è un tipo supportato di archivio di serializzazione. Usare un archivio restituito da CreateStore().
Commenti
La serializzazione standard, implementata tramite il Serialize metodo , serializza solo i valori che differiscono dallo stato predefinito del componente. Ciò fornisce il meccanismo di serializzazione più compatto, ma presuppone che un oggetto appena creato venga usato durante la deserializzazione. Se viene utilizzato un oggetto esistente, non è garantito che l'oggetto deserializzato risultante duplici lo stato originale dell'oggetto serializzato; Le proprietà che contengono valori predefiniti durante la serializzazione non verranno reimpostate sulle impostazioni predefinite durante la deserializzazione.
Il SerializeAbsolute metodo non usa questo collegamento. Serializza tutte le proprietà dell'oggetto di origine in modo che la deserializzazione possa ripristinare tutte le proprietà dell'oggetto, indipendentemente dallo stato predefinito.
Questo metodo è particolarmente utile per la serializzazione delle raccolte, perché l'ordine degli elementi costitutivi all'interno della raccolta può cambiare. In questa circostanza, il processo più sicuro per ripristinare lo stato originale dell'intera raccolta consiste nel sovrascrivere tutti gli elementi con tutti i relativi valori di proprietà originali.