Partilhar via


ComponentSerializationService.SerializeAbsolute Método

Definição

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 -> 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.

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.

Aplica-se a

Confira também