TypeConverter.ConvertTo 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

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

多載

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

要將 value 參數轉換成的 Type。

傳回

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

要將 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 類型轉換器的概觀