ComponentSerializationService.SerializeAbsolute Metodo

Definizione

Spazio dei nomi:

System.ComponentModel.Design.Serialization

Assembly:

System.ComponentModel.TypeConverter.dll

Origine:

ComponentSerializationService.cs

Serializza l'oggetto dato, tenendo conto dei valori di proprietà predefiniti.

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)

Parametri

store

SerializationStore

Classe SerializationStore in cui verrà serializzato lo stato di value.

value

Object

Oggetto da serializzare.

Eccezioni

ArgumentNullException

store o value è null.

InvalidOperationException

store viene chiuso o store non è un tipo di archivio di serializzazione supportato. Usare un archivio restituito da CreateStore().

Commenti

Serializzazione standard, come implementato tramite il Serialize metodo, serializza solo i valori che differiscono dallo stato predefinito del componente. In questo modo viene fornito il meccanismo di serializzazione più compatta, ma si presuppone che un oggetto appena creato venga usato durante la deserializzazione. Se viene usato un oggetto esistente, l'oggetto deserializzato risultante non è garantito duplicare lo stato originale dell'oggetto serializzato; le proprietà che contengono valori predefiniti durante la serializzazione non verranno ripristinate nelle 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 valori delle proprietà originali.

Vedi anche

• SerializationStore
• MemberDescriptor
• Serialize(SerializationStore, Object)
• SerializeMember(SerializationStore, Object, MemberDescriptor)
• SerializeMemberAbsolute(SerializationStore, Object, MemberDescriptor)