ComponentSerializationService.SerializeAbsolute(SerializationStore, Object) Método
Definição
Serializa o objeto fornecido, considerando valores de propriedade padrão.Serializes the given object, accounting for default property values.
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
O SerializationStore no qual o estado do value será serializado.The SerializationStore to which the state of value will be serialized.
- value
- Object
O objeto a ser serializado.The object to serialize.
Exceções
store ou value é null.store or value is null.
store está fechado ou store não é um tipo de repositório de serialização compatível.store is closed, or store is not a supported type of serialization store. Use um repositório retornado por CreateStore().Use a store returned by CreateStore().
Comentários
A serialização padrão, conforme implementada por meio do Serialize método, serializa apenas valores que diferem do estado padrão do componente.Standard serialization, as implemented through the Serialize method, only serializes values that differ from the component's default state. Isso fornece o mecanismo de serialização mais compacto, mas pressupõe que um objeto recém-criado será usado durante a desserialização.This provides the most compact serialization mechanism but assumes that a newly created object will be used during deserialization. Se um objeto existente for usado, o objeto desserializado resultante não terá garantia de duplicar o estado original do objeto serializado; as propriedades que continham valores padrão durante a serialização não serão redefinidas de volta para seus padrões durante a desserialização.If an existing object is used, the resulting deserialized object is not guaranteed to duplicate the original state of the serialized object; the properties that contained default values during serialization will not be reset back to their defaults during deserialization.
O SerializeAbsolute método não usa esse atalho.The SerializeAbsolute method does not use this shortcut. Ele serializa todas as propriedades do objeto de origem para que a desserialização possa restaurar todas as propriedades do objeto, independentemente do estado padrão.It serializes all properties of the source object so that deserialization can restore all the object's properties, regardless of default state.
Esse método é particularmente útil para a serialização de coleções, pois a ordem dos itens constituintes na coleção pode ser alterada.This method is particularly useful for serializing collections, because the order of the constituent items within the collection can change. Nessa circunstância, o processo mais seguro para restaurar o estado original da coleção inteira é substituir todos os itens por todos os seus valores de propriedade originais.In this circumstance, the safest process to restore the original state of the entire collection is to overwrite all the items with all their original property values.