TypeConverter.ConvertTo Método

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Converte o objeto de valor atribuído no tipo especificado.

Sobrecargas

ConvertTo(Object, Type)	Converte o objeto de valor especificado para o tipo especificado, usando os argumentos.
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte o objeto de valor determinado para o tipo especificado, usando o contexto especificado e as informações da cultura.

ConvertTo(Object, Type)

Origem:

TypeConverter.cs

Converte o objeto de valor especificado para o tipo especificado, usando os argumentos.

public:
 System::Object ^ ConvertTo(System::Object ^ value, Type ^ destinationType);

public object? ConvertTo (object? value, Type destinationType);

member this.ConvertTo : obj * Type -> obj

Public Function ConvertTo (value As Object, destinationType As Type) As Object

Parâmetros

value

Object

O Object a ser convertido.

destinationType

Type

O Type para converter o parâmetro value.

Retornos

Object

Um Object que representa o valor convertido.

Exceções

ArgumentNullException

O parâmetro destinationType é null.

NotSupportedException

A conversão não pode ser executada.

Comentários

O tipo mais comum para converter de e para é um objeto de cadeia de caracteres. Essa implementação chamará ToString no objeto , se o objeto for válido e se o tipo de destino for uma cadeia de caracteres.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Origem:

TypeConverter.cs

Converte o objeto de valor determinado para o tipo especificado, usando o contexto especificado e as informações da cultura.

public:
 virtual System::Object ^ ConvertTo(System::ComponentModel::ITypeDescriptorContext ^ context, System::Globalization::CultureInfo ^ culture, System::Object ^ value, Type ^ destinationType);

public virtual object? ConvertTo (System.ComponentModel.ITypeDescriptorContext? context, System.Globalization.CultureInfo? culture, object? value, Type destinationType);

abstract member ConvertTo : System.ComponentModel.ITypeDescriptorContext * System.Globalization.CultureInfo * obj * Type -> obj
override this.ConvertTo : System.ComponentModel.ITypeDescriptorContext * System.Globalization.CultureInfo * obj * Type -> obj

Public Overridable Function ConvertTo (context As ITypeDescriptorContext, culture As CultureInfo, value As Object, destinationType As Type) As Object

Parâmetros

context

ITypeDescriptorContext

Um ITypeDescriptorContext que fornece um contexto de formato.

culture

CultureInfo

Um CultureInfo. Se null for passado, a cultura atual será assumida.

value

Object

O Object a ser convertido.

destinationType

Type

O Type para converter o parâmetro value.

Retornos

Object

Um Object que representa o valor convertido.

Exceções

ArgumentNullException

O parâmetro destinationType é null.

NotSupportedException

A conversão não pode ser executada.

Comentários

Os tipos mais comuns para converter são de e para um objeto de cadeia de caracteres. Essa implementação chamará ToString no objeto se o objeto for válido e se o tipo de destino for uma cadeia de caracteres.

Use o context parâmetro para extrair informações adicionais sobre o ambiente do qual esse conversor é invocado. Esse parâmetro pode ser null, portanto, sempre marcar-lo. Além disso, as propriedades no objeto de contexto podem retornar null.

Autores de tipo personalizado que pretendem dar suporte a um comportamento de conversão de tipo para XAML normalmente implementam uma TypeConverter classe que dá suporte ao comportamento de uma cadeia de caracteres ConvertFrom . Esses conversores de tipo também podem ser implementados ConvertTo para dar suporte à serialização de volta ao XAML.

Alguns cenários de serialização XAML não podem ser tratados adequadamente sozinhos TypeConverter . Nesses casos, pode ser necessário também definir um ValueSerializer que manipula os casos de serialização que, de outra forma, seriam tratados por ConvertTo. Para obter mais informações, consulte ValueSerializer.

Notas aos Herdeiros

Substitua esse método para fornecer seus próprios requisitos de conversão.

Para obter padrões de implementação para conversores de tipo usados para dar suporte a XAML e tipos personalizados, consulte Conversores de tipo para visão geral de XAML.

Confira também

• ITypeDescriptorContext
• Visão geral dos conversores de tipo para XAML