ComponentSerializationService.SerializeAbsolute Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
store
o value
es null
.
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.