ComponentSerializationService.SerializeAbsolute Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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
store ou value est null.
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.
