ComponentSerializationService.SerializeAbsolute Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Serializa o objeto dado, tendo em conta os valores padrão das propriedades.
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)Parâmetros
- store
- SerializationStore
O SerializationStore para o qual o estado de value será serializado.
- value
- Object
O objetivo a serializar.
Exceções
store ou value é null.
store é fechado, ou store não é um tipo suportado de armazenamento de serialização. Use uma loja devolvida por CreateStore().
Observações
A serialização padrão, tal como implementada através do Serialize método, serializa apenas valores que diferem do estado padrão do componente. Isto fornece o mecanismo de serialização mais compacto, mas assume que um objeto recém-criado será usado durante a desserialização. Se um objeto existente for utilizado, o objeto deserializado resultante não garante duplicar o estado original do objeto serializado; As propriedades que continham valores predefinidos durante a serialização não serão reiniciadas para os valores predefinidos durante a desserialização.
O SerializeAbsolute método não utiliza este atalho. 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.
Este método é particularmente útil para serializar coleções, porque a ordem dos itens constituintes dentro da coleção pode mudar. Nesta circunstância, o processo mais seguro para restaurar o estado original de toda a coleção é sobrescrever todos os itens pelos seus valores originais de propriedade.