TypeConverter.ConvertTo Método

Definição

Namespace:: System.ComponentModel

Assemblies:: netstandard.dll, System.ComponentModel.TypeConverter.dll

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

Converte o objeto de valor fornecido no tipo especificado.

Sobrecargas

Nome	Description
ConvertTo(Object, Type)	Converte o objeto de valor fornecido no tipo especificado, usando os argumentos.
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte o objeto de valor fornecido no tipo especificado, usando as informações de contexto e cultura especificadas.

ConvertTo(Object, Type)

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

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

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

public object? ConvertTo(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 para converter.

destinationType: Type

O Type para o qual converter o value parâmetro.

Retornos

Object

Um Object que representa o valor convertido.

Exceções

ArgumentNullException

O destinationType parâmetro é 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 o objeto, se o objeto for válido e se o tipo de destino for uma cadeia de caracteres.

Aplica-se a

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Origem:: TypeConverter.cs

Converte o objeto de valor fornecido no tipo especificado, usando as informações de contexto e cultura especificadas.

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);

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 aprovada, a cultura atual será assumida.

value: Object

O Object para converter.

destinationType: Type

O Type para o qual converter o value parâmetro.

Retornos

Object

Um Object que representa o valor convertido.

Exceções

ArgumentNullException

O destinationType parâmetro é null.

NotSupportedException

A conversão não pode ser executada.

Comentários

Os tipos mais comuns a serem convertidos são de e para um objeto de cadeia de caracteres. Essa implementação chamará ToString o 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 verifique-o. 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 TypeConverter adequadamente sozinhos. Nesses casos, pode ser necessário também definir um ValueSerializer que trate 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 de conversores de tipo para XAML

Aplica-se a

Comentários

Esta página foi útil?