ComponentSerializationService.SerializeAbsolute Método

Definição

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.ComponentModel.TypeConverter.dll

Origem:

ComponentSerializationService.cs

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

ArgumentNullException

store ou value é null.

InvalidOperationException

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.

Confira também

• SerializationStore
• MemberDescriptor
• Serialize(SerializationStore, Object)
• SerializeMember(SerializationStore, Object, MemberDescriptor)
• SerializeMemberAbsolute(SerializationStore, Object, MemberDescriptor)