TypeConverter.ConvertTo Método

Definición

Convierte el objeto de valor determinado al tipo especificado.

Sobrecargas

ConvertTo(Object, Type)

Convierte el objeto de valor dado al tipo especificado, utilizando los argumentos.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Convierte el objeto de valor dado al tipo especificado, utilizando el contexto y la información de referencia cultural especificados.

ConvertTo(Object, Type)

Convierte el objeto de valor dado al tipo especificado, utilizando los 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

Valor Object que se va a convertir.

destinationType
Type

Type al que se va a convertir el parámetro value.

Devoluciones

Object

Object que representa el valor convertido.

Excepciones

El parámetro destinationType es null.

No se puede realizar la conversión.

Comentarios

El tipo más común para convertir en y desde es un objeto de cadena. Esta implementación llama ToString al objeto , si el objeto es válido y si el tipo de destino es una cadena.

Se aplica a

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Convierte el objeto de valor dado al tipo especificado, utilizando el contexto y la información de referencia cultural especificados.

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

ITypeDescriptorContext que ofrece un contexto de formato.

culture
CultureInfo

Objeto CultureInfo. Si se pasa null, se supone que se va a usar la referencia cultural actual.

value
Object

Valor Object que se va a convertir.

destinationType
Type

Type al que se va a convertir el parámetro value.

Devoluciones

Object

Object que representa el valor convertido.

Excepciones

El parámetro destinationType es null.

No se puede realizar la conversión.

Comentarios

Las conversiones de tipos más frecuentes son las conversiones a objetos de cadena y desde objetos de cadena. Esta implementación llama ToString al objeto si el objeto es válido y si el tipo de destino es una cadena.

Utilice el parámetro context para extraer información adicional sobre el entorno desde el que se llama a este convertidor. Este parámetro puede ser null, por lo que siempre debe comprobarlo. Asimismo, las propiedades del objeto de contexto pueden devolver null.

Los autores de tipos personalizados que pretenden admitir un comportamiento de conversión de tipos para XAML suelen implementar una TypeConverter clase que admita ConvertFrom el comportamiento de una cadena. Estos convertidores de tipos también se pueden implementar ConvertTo para admitir la serialización en XAML.

Algunos escenarios de serialización XAML no se pueden abordar adecuadamente solos TypeConverter . En estos casos, puede ser necesario definir también un ValueSerializer que controle los casos de serialización que, de lo contrario, se controlarían mediante ConvertTo. Para obtener más información, vea ValueSerializer.

Notas a los desarrolladores de herederos

Invalide este método para proporcionar sus propios requisitos de conversión.

Para obtener patrones de implementación para convertidores de tipos que se usan para admitir tipos XAML y personalizados, consulta Convertidores de tipos para información general sobre XAML.

Consulte también

Se aplica a