ValueSerializer Classe

Definição

Classe abstrata que define o comportamento de conversão para a serialização de uma representação de objeto.Abstract class that defines conversion behavior for serialization from an object representation.

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 sempre deve retornar a mesma cadeia de caracteres para um valor específico.The string a converter returns for serialization must be loss-less and the converter must always return the same string for a particular value. Se um conversor de tipo (derivado TypeConverterde) não atender a esses requisitos em ConvertTo suas implementações para saída de cadeia ValueSerializer de caracteres, um personalizado deverá ser declarado.If a type converter (derived from TypeConverter) does not meet these requirements in its ConvertTo implementations for string output, a custom ValueSerializer must be declared. O ValueSerializer deve atender aos requisitos ou um nulo ValueSerializer deve ser associado ao tipo.Either the ValueSerializer should meet the requirements, or a null ValueSerializer should be associated with the type. Um ValueSerializer é associado a um tipo aplicando o ValueSerializerAttribute atributo.A ValueSerializer is associated with a type by applying the ValueSerializerAttribute attribute.

Um NULL ValueSerializer indica que o conversor de tipo deve ser ignorado para conversões de conversão em cadeia de caracteres do grafo do objeto.A null ValueSerializer indicates the type converter should be ignored for convert-to-string conversions from the object graph.

Importante

A implementação ValueSerializer de deve evitar lançar exceções.Implementation of ValueSerializer should avoid throwing exceptions. As exceções geradas podem terminar a serialização.Any exceptions thrown could terminate serialization.

IValueSerializerContextpara uma ValueSerializer e suas APIs são análogas ITypeDescriptorContext a para TypeConverterum.IValueSerializerContext for a ValueSerializer and its APIs is analogous to ITypeDescriptorContext for a TypeConverter. Na verdade, IValueSerializerContext o ITypeDescriptorContextherda.In fact, IValueSerializerContext inherits 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.When a ValueSerializer derived class API is called, the caller (typically a serializer process) passes a context that may provide certain services. Devido às diretrizes gerais, um ValueSerializer não deve gerar exceções.Because of the general guidance that a ValueSerializer must not throw exceptions. A falha ao retornar um serviço específico do contexto também não deve gerar nenhuma exceção.Failure to return a particular service from the context must also not throw any exceptions.

Nas versões anteriores do .NET Framework, essa classe existia no assembly WindowsBase específico do WPF.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. No .NET Framework 4.NET Framework 4 ,ValueSerializer está no assembly System. XAML.In .NET Framework 4.NET Framework 4, ValueSerializer is in the System.Xaml assembly. Para obter mais informações, consulte tipos migrados do WPF para System. XAML.For more information, see Types Migrated from WPF to System.Xaml.

Construtores

ValueSerializer()

Inicializa uma nova instância da classe ValueSerializer.Initializes a new instance of the ValueSerializer class.

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.When overridden in a derived class, determines whether the specified String can be converted to an instance of the type that the implementation of ValueSerializer supports.

CanConvertToString(Object, IValueSerializerContext)

Quando substituído em uma classe derivada, determina se o objeto especificado pode ser convertido em um String.When overridden in a derived class, determines whether the specified object can be converted into a 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.When overridden in a derived class, converts a String to an instance of the type that the implementation of ValueSerializer supports.

ConvertToString(Object, IValueSerializerContext)

Quando substituído em uma classe derivada, converte o objeto especificado em um String.When overridden in a derived class, converts the specified object to a String.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetConvertFromException(Object)

Retorna uma exceção a ser gerada quando uma conversão não puder ser executada.Returns an exception to throw when a conversion cannot be performed.

GetConvertToException(Object, Type)

Retorna uma exceção a ser gerada quando uma conversão não puder ser executada.Returns an exception to throw when a conversion cannot be performed.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetSerializerFor(PropertyDescriptor)

Obtém o ValueSerializer declarado para uma propriedade, passando um descritor de propriedade CLR para a propriedade.Gets the ValueSerializer declared for a property, by passing a CLR property descriptor for the property.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

Obtém o ValueSerializer declarado para a propriedade especificada usando o contexto especificado.Gets the ValueSerializer declared for the specified property, using the specified context.

GetSerializerFor(Type)

Obtém o ValueSerializer declarado para o tipo especificado.Gets the ValueSerializer declared for the specified type.

GetSerializerFor(Type, IValueSerializerContext)

Obtém o ValueSerializer declarado para o tipo especificado usando o contexto especificado.Gets the ValueSerializer declared for the specified type, using the specified context.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
TypeReferences(Object, IValueSerializerContext)

Obtém uma enumeração dos tipos referenciados pelo ValueSerializer.Gets an enumeration of the types referenced by the ValueSerializer.

Aplica-se a

Veja também