TypeConverter.ConvertTo 方法

定义

命名空间:

System.ComponentModel

程序集:

netstandard.dll, System.ComponentModel.TypeConverter.dll

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

重载

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

ConvertTo(Object, Type)

Source:

TypeConverter.cs

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

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

参数

value

Object

要 Object 转换的。

destinationType

Type

要 Type 将参数转换为的参数 value 。

返回

Object

一个 Object 表示转换后的值。

例外

ArgumentNullException

参数 destinationType 为 null.

NotSupportedException

无法执行转换。

注解

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

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Source:

TypeConverter.cs

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

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

参数

context

ITypeDescriptorContext

提供格式上下文的一 ITypeDescriptorContext 个。

culture

CultureInfo

CultureInfo。 如果 null 传递，则假定当前区域性。

value

Object

要 Object 转换的。

destinationType

Type

要 Type 将参数转换为的参数 value 。

返回

Object

一个 Object 表示转换后的值。

例外

ArgumentNullException

参数 destinationType 为 null.

NotSupportedException

无法执行转换。

注解

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

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

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

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

继承者说明

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

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

另请参阅

• ITypeDescriptorContext
• XAML 的类型转换器概述