TypeConverter.ConvertTo 方法

定義

命名空間:

System.ComponentModel

組件:

netstandard.dll, System.ComponentModel.TypeConverter.dll

將給定值物件轉換為指定的型別。

多載

名稱	Description
ConvertTo(Object, Type)	利用參數將給定值物件轉換為指定的型別。
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	利用指定的上下文與文化資訊，將給定的值物件轉換為指定的型別。

ConvertTo(Object, Type)

來源:

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)

來源:

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 型別轉換器概述