TypeConverter.ConvertTo 方法

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

程序集:

System.dll

程序集:

netstandard.dll

将给定的值对象转换为指定的类型。

重载

ConvertTo(Object, Type)	使用参数将给定的值对象转换为指定的类型。
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	使用指定的上下文和区域性信息将给定值对象转换为指定的类型。

ConvertTo(Object, Type)

使用参数将给定的值对象转换为指定的类型。

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

参数

value

Object

要转换的 Object。

destinationType

Type

value 参数要转换成的 Type。

返回

Object

一个 Object，它表示转换后的值。

例外

ArgumentNullException

destinationType 参数为 null。

NotSupportedException

无法执行转换。

注解

要转换到和传出的最常用类型是字符串对象。 如果对象有效且目标类型为字符串，则此实现调用 ToString 对象。

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

使用指定的上下文和区域性信息将给定值对象转换为指定的类型。

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

参数

context

ITypeDescriptorContext

一个 ITypeDescriptorContext，用于提供格式上下文。

culture

CultureInfo

CultureInfo。 如果传递 null，则采用当前区域性。

value

Object

要转换的 Object。

destinationType

Type

value 参数要转换成的 Type。

返回

Object

一个 Object，它表示转换后的值。

例外

ArgumentNullException

destinationType 参数为 null。

NotSupportedException

无法执行转换。

注解

最常见的转换类型是与字符串对象的相互转换。 如果对象有效且目标类型为字符串，则此实现将调用 ToString 对象。

使用 context 参数提取有关调用此转换器的环境的附加信息。 此参数可以是 null，因此请始终检查它。 同样，上下文对象的属性可以返回 null。

打算支持 XAML 的类型转换行为的自定义类型作者通常实现一个 TypeConverter 支持 ConvertFrom 字符串中行为的类。 这些类型转换器还可能实现 ConvertTo 以支持序列化回 XAML。

某些 XAML 序列化方案不能单独处理 TypeConverter 。 在这些情况下，可能还需要定义一个 ValueSerializer 处理由其他方式处理的 ConvertTo序列化事例。 有关详细信息，请参阅 ValueSerializer。

继承者说明

重写该方法以提供您自己的转换要求。

有关用于支持 XAML 和自定义类型的类型转换器的实现模式，请参阅 XAML 类型转换器概述。

另请参阅

• ITypeDescriptorContext
• XAML 类型转换器概述