ComponentSerializationService.SerializeAbsolute Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Serializa o objeto fornecido, considerando valores de propriedade padrão.
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 no qual o estado do value será serializado.
- value
- Object
O objeto a ser serializado.
Exceções
store ou value é null.
store está fechado ou store não é um tipo de repositório de serialização compatível. Use um repositório retornado por CreateStore().
Comentários
A serialização padrão, conforme implementado por meio do Serialize método , serializa apenas valores que diferem do estado padrão do componente. Isso fornece o mecanismo de serialização mais compacto, mas pressupõe que um objeto recém-criado será usado durante a desserialização. Se um objeto existente for usado, o objeto desserializado resultante não terá a 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 para seus padrões durante a desserialização.
O SerializeAbsolute método não usa esse atalho. 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.
Esse método é particularmente útil para serializar coleções, pois a ordem dos itens constituintes dentro da coleção pode ser alterada. Nessa circunstância, o processo mais seguro para restaurar o estado original de toda a coleção é substituir todos os itens por todos os seus valores de propriedade originais.
