ComponentSerializationService.SerializeAbsolute Méthode

Définition

Espace de noms:

System.ComponentModel.Design.Serialization

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

ComponentSerializationService.cs

Sérialise l'objet donné en prenant en compte les valeurs de propriétés par défaut.

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)

Paramètres

store

SerializationStore

SerializationStore dans lequel l'état de value sera sérialisé.

value

Object

L'objet à sérialiser.

Exceptions

ArgumentNullException

store ou value est null.

InvalidOperationException

store est fermé ou store n’est pas un type de magasin de sérialisation pris en charge. Utilisez un magasin retourné par CreateStore().

Remarques

La sérialisation standard, telle qu’implémentée via la Serialize méthode, sérialise uniquement les valeurs qui diffèrent de l’état par défaut du composant. Cela fournit le mécanisme de sérialisation le plus compact, mais suppose qu’un objet nouvellement créé sera utilisé pendant la désérialisation. Si un objet existant est utilisé, l’objet désérialisé résultant n’est pas garanti pour dupliquer l’état d’origine de l’objet sérialisé ; les propriétés qui contenaient des valeurs par défaut pendant la sérialisation ne seront pas réinitialisées à leurs valeurs par défaut pendant la désérialisation.

La SerializeAbsolute méthode n’utilise pas ce raccourci. Il sérialise toutes les propriétés de l’objet source afin que la désérialisation puisse restaurer toutes les propriétés de l’objet, quel que soit l’état par défaut.

Cette méthode est particulièrement utile pour sérialiser des collections, car l’ordre des éléments constitutifs de la collection peut changer. Dans ce cas, le processus le plus sûr pour restaurer l’état d’origine de l’ensemble de la collection consiste à remplacer tous les éléments par toutes leurs valeurs de propriété d’origine.

Voir aussi

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