ValueSerializer Classe

Definição

Espaço de Nomes:
System.Windows.Markup
Assemblagem:
WindowsBase.dll
Assemblagem:
System.Xaml.dll

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

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

Observações

A cadeia que um conversor devolve para serialização deve ser sem perdas e o conversor deve sempre devolver a mesma cadeia para um determinado valor. Se um conversor de tipos (derivado de TypeConverter) não cumprir estes requisitos nas suas ConvertTo implementações para a saída de cadeias, deve ser declarado um custom ValueSerializer . Ou devem ValueSerializer cumprir os requisitos, ou um nulo ValueSerializer deve ser associado ao tipo. A ValueSerializer está associado a um tipo aplicando o ValueSerializerAttribute atributo.

Um null ValueSerializer indica que o conversor de tipos deve ser ignorado para conversões de conversão para string a partir do grafo objeto.

Importante

A implementação de ValueSerializer deve evitar lançar exceções. Quaisquer exceções lançadas podiam terminar a serialização.

IValueSerializerContext para a ValueSerializer e as suas APIs é análogo a ITypeDescriptorContext para um TypeConverter. Na verdade, IValueSerializerContext herda ITypeDescriptorContext. Quando uma ValueSerializer API de classe derivada é chamada, o chamador (tipicamente um processo serializador) passa um contexto que pode fornecer certos serviços. Por causa da orientação geral de que não ValueSerializer deve lançar exceções. A falha em devolver um determinado serviço do contexto também não deve lançar quaisquer exceções.

Em versões anteriores do .NET Framework, esta classe existia no conjunto específico do WPF WindowsBase. Na .NET Framework 4, ValueSerializer está na assembly System.Xaml. Para mais informações, veja Tipos Migrados de WPF para System.Xaml.

Construtores

Name Description
ValueSerializer()

Inicializa uma nova instância da ValueSerializer classe.

Métodos

Name Description
CanConvertFromString(String, IValueSerializerContext)

Quando sobrescrito numa classe derivada, determina se o especificado String pode ser convertido numa instância do tipo que a implementação suporta ValueSerializer .
CanConvertToString(Object, IValueSerializerContext)

Quando sobreposto numa classe derivada, determina se o objeto especificado pode ser convertido num String.
ConvertFromString(String, IValueSerializerContext)

Quando sobrescrito numa classe derivada, converte a String numa instância do tipo que a implementação suporta ValueSerializer .
ConvertToString(Object, IValueSerializerContext)

Quando sobrescrito numa classe derivada, converte o objeto especificado num String.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetConvertFromException(Object)

Devolve uma exceção ao lançamento quando uma conversão não pode ser realizada.
GetConvertToException(Object, Type)

Devolve uma exceção ao lançamento quando uma conversão não pode ser realizada.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Obtém o ValueSerializer declarado para a propriedade especificada, usando o contexto especificado.
GetSerializerFor(PropertyDescriptor)

Obtém o ValueSerializer declarado para uma propriedade, passando um descritor de propriedade CLR para a propriedade.
GetSerializerFor(Type, IValueSerializerContext)

Obtém o ValueSerializer declarado para o tipo especificado, usando o contexto especificado.
GetSerializerFor(Type)

Obtém o ValueSerializer declarado para o tipo especificado.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TypeReferences(Object, IValueSerializerContext)

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

Aplica-se a

Ver também