Compartilhar via


ValueSerializer Classe

Definição

Classe abstrata que define o comportamento de conversão para a serialização de uma representação de objeto.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
Herança
ValueSerializer
Derivado

Comentários

A cadeia de caracteres que um conversor retorna para serialização deve ser sem perda e o conversor deve sempre retornar a mesma cadeia de caracteres para um valor específico. Se um conversor de tipo (derivado de TypeConverter) não atender a esses requisitos em suas ConvertTo implementações para saída de cadeia de caracteres, um personalizado ValueSerializer deverá ser declarado. ValueSerializer O deve atender aos requisitos ou um nulo ValueSerializer deve ser associado ao tipo . Um ValueSerializer é associado a um tipo aplicando o ValueSerializerAttribute atributo .

Um nulo ValueSerializer indica que o conversor de tipo deve ser ignorado para conversões de conversão em cadeia de caracteres do grafo de objeto.

Importante

A implementação de ValueSerializer deve evitar gerar exceções. Todas as exceções geradas podem encerrar a serialização.

IValueSerializerContext para um ValueSerializer e suas APIs são análogas a ITypeDescriptorContext para um TypeConverter. Na verdade, IValueSerializerContext herda ITypeDescriptorContext. Quando uma ValueSerializer API de classe derivada é chamada, o chamador (normalmente um processo de serializador) passa um contexto que pode fornecer determinados serviços. Devido às diretrizes gerais de que um ValueSerializer não deve gerar exceções. A falha ao retornar um serviço específico do contexto também não deve gerar exceções.

Em versões anteriores do .NET Framework, essa classe existia no assembly específico do WPF WindowsBase. No .NET Framework 4, ValueSerializer está no assembly System.Xaml. Para obter mais informações, consulte Tipos migrados do WPF para System.Xaml.

Construtores

ValueSerializer()

Inicializa uma nova instância da classe ValueSerializer.

Métodos

CanConvertFromString(String, IValueSerializerContext)

Quando substituído em uma classe derivada, determina se o String especificado pode ser convertido em uma instância do tipo compatível com a implementação de ValueSerializer.

CanConvertToString(Object, IValueSerializerContext)

Quando substituído em uma classe derivada, determina se o objeto especificado pode ser convertido em um String.

ConvertFromString(String, IValueSerializerContext)

Quando substituído em uma classe derivada, converte um String em uma instância do tipo compatível com a implementação de ValueSerializer.

ConvertToString(Object, IValueSerializerContext)

Quando substituído em uma classe derivada, converte o objeto especificado em um String.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetConvertFromException(Object)

Retorna uma exceção a ser gerada quando uma conversão não puder ser executada.

GetConvertToException(Object, Type)

Retorna uma exceção a ser gerada quando uma conversão não puder ser executada.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetSerializerFor(PropertyDescriptor)

Obtém o ValueSerializer declarado para uma propriedade, passando um descritor de propriedade CLR para a propriedade.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Obtém o ValueSerializer declarado para a propriedade especificada usando o contexto especificado.

GetSerializerFor(Type)

Obtém o ValueSerializer declarado para o tipo especificado.

GetSerializerFor(Type, IValueSerializerContext)

Obtém o ValueSerializer declarado para o tipo especificado usando o contexto especificado.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TypeReferences(Object, IValueSerializerContext)

Obtém uma enumeração dos tipos referenciados pelo ValueSerializer.

Aplica-se a

Confira também