System.ComponentModel.TypeConverter.ConvertTo 方法 (ITypeDescriptorContext, CultureInfo, Object, Type)

方法描述

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

语法定义(C# System.ComponentModel.TypeConverter.ConvertTo 方法 (ITypeDescriptorContext, CultureInfo, Object, Type) 的用法)

public virtual Object ConvertTo(
	ITypeDescriptorContext context,
	CultureInfo culture,
	Object value,
	Type destinationType
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
context System-ComponentModel-ITypeDescriptorContext 一个提供格式上下文的 ITypeDescriptorContext。
culture System-Globalization-CultureInfo CultureInfo 。如果传递 null，则采用当前区域性。
value System-Object 要转换的 Object。
destinationType System-Type value 参数要转换成的 Type。
返回值 System.Object 表示转换的 value 的 Object。

提示和注释

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

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

想要支持 XAML 的类型转换行为的自定义类型作者通常实现 TypeConverter 类，该类支持来自字符串的 ConvertFrom 行为。 这些类型转换器还可能会实现 ConvertTo，以支持回到 XAML 的序列化。

某些 XAML 序列化方案不能单独用 TypeConverter 来充分解决。 在这些情况下，有必要同时定义 ValueSerializer 来处理序列化情况，否则序列化情况将由 ConvertTo 处理。 有关更多信息，请参见 ValueSerializer。

对继承者的说明

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

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

System.ComponentModel.TypeConverter.ConvertTo 方法 (ITypeDescriptorContext, CultureInfo, Object, Type)例子

异常

异常 异常描述
ArgumentNullException destinationType 参数为 null。
NotSupportedException 不能执行转换。

命名空间

namespace: System.ComponentModel

程序集: System（在 System.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

相关资源

TypeConverter 类
ConvertTo 重载
System.ComponentModel 命名空间
ITypeDescriptorContext
XAML 的类型转换器概述
MSDN