ComponentSerializationService.SerializeAbsolute Método

Definición

Espacio de nombres:

System.ComponentModel.Design.Serialization

Ensamblado:

System.ComponentModel.TypeConverter.dll

Source:

ComponentSerializationService.cs

Serializa el objeto dado, teniendo en cuenta los valores de propiedad predeterminados.

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)

Parámetros

store

SerializationStore

Objeto SerializationStore en el que se serializará el estado de value.

value

Object

El objeto que se va a serializar.

Excepciones

ArgumentNullException

store o value es null.

InvalidOperationException

store está cerrado o store no es un tipo admitido de almacén de serialización. Use un almacén devuelto por CreateStore().

Comentarios

La serialización estándar, tal como se implementa a través del Serialize método , solo serializa los valores que difieren del estado predeterminado del componente. Esto proporciona el mecanismo de serialización más compacto, pero supone que se usará un objeto recién creado durante la deserialización. Si se usa un objeto existente, no se garantiza que el objeto deserializado resultante duplique el estado original del objeto serializado; las propiedades que contenían valores predeterminados durante la serialización no se restablecerán a sus valores predeterminados durante la deserialización.

El SerializeAbsolute método no usa este acceso directo. Serializa todas las propiedades del objeto de origen para que la deserialización pueda restaurar todas las propiedades del objeto, independientemente del estado predeterminado.

Este método es especialmente útil para serializar colecciones, ya que el orden de los elementos constituyentes dentro de la colección puede cambiar. En esta circunstancia, el proceso más seguro para restaurar el estado original de toda la colección es sobrescribir todos los elementos con todos sus valores de propiedad originales.

Consulte también

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