ValueSerializer Classe
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.
Classe abstrata que define o comportamento de conversão para serialização de uma representação de objeto.
public ref class ValueSerializer abstractpublic abstract class ValueSerializertype ValueSerializer = classPublic 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 valor deve atender aos requisitos ou um valor nulo ValueSerializer deve ser associado ao tipo. A 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 deve ValueSerializer evitar a geração de exceções. Todas as exceções geradas podem encerrar a serialização.
IValueSerializerContext para um ValueSerializer e suas APIs é análogo a ITypeDescriptorContext um TypeConverter. Na verdade, IValueSerializerContext herda ITypeDescriptorContext. Quando uma ValueSerializer API de classe derivada é chamada, o chamador (normalmente um processo de serializador) passa por um contexto que pode fornecer determinados serviços. Devido à orientação geral de que não ValueSerializer é necessário gerar exceções. A falha ao retornar um serviço específico do contexto também não deve gerar exceções.
Nas 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
| Nome | Description |
|---|---|
| ValueSerializer() |
Inicializa uma nova instância da classe ValueSerializer. |
Métodos
| Nome | Description |
|---|---|
| CanConvertFromString(String, IValueSerializerContext) |
Quando substituído em uma classe derivada, determina se o especificado String pode ser convertido em uma instância do tipo que a implementação de ValueSerializer dá suporte. |
| 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 em uma String instância do tipo que a implementação de ValueSerializer dá suporte. |
| 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 pode ser executada. |
| GetConvertToException(Object, Type) |
Retorna uma exceção a ser gerada quando uma conversão não pode ser executada. |
| GetHashCode() |
Serve como a função 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 Objectatual. (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. |