語言

TypeConverter.ConvertTo 方法

定義

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

多載

名稱 Description
ConvertTo(Object, Type)

利用參數將給定值物件轉換為指定的型別。

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

使用指定的內容和文化特性資訊,將指定的值物件轉換成指定的型別。

ConvertTo(Object, Type)

來源:
TypeConverter.cs
來源:
TypeConverter.cs
來源:
TypeConverter.cs
來源:
TypeConverter.cs
來源:
TypeConverter.cs

利用參數將給定值物件轉換為指定的型別。

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

該 Type 參數轉換為 value 。

傳回

代表 Object 轉換後的值。

例外狀況

參數 destinationType 為 null。

轉換無法執行。

備註

最常見的轉換到和從 的類型是字串物件。 此實作會呼叫 ToString 物件,前提是物件有效且目的類型是字串。

適用於

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

來源:
TypeConverter.cs
來源:
TypeConverter.cs
來源:
TypeConverter.cs
來源:
TypeConverter.cs
來源:
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);
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 轉換後的值。

例外狀況

參數 destinationType 為 null。

轉換無法執行。

備註

最常見的轉換類型是與字串物件之間的轉換。 此實作會在物件有效且目的型別為字串時呼叫 ToString 該物件。

利用參數 context 擷取關於該轉換器所使用的環境的額外資訊。 這個參數可以是 null,所以一定要檢查。 此外,上下文物件上的屬性也可以回傳 null。

想要支援 XAML 型態轉換行為的自訂型別作者,通常會實作 TypeConverter 一個支援 ConvertFrom 字串行為的類別。 這些型別轉換器也可能支援 ConvertTo 回 XAML 的序列化。

有些 XAML 序列化情境無法單獨處理 TypeConverter 。 在這些情況下,可能還需要定義 ValueSerializer 一個處理序列化情況的 ,而這些序列化的情況本應由 ConvertTo處理。 如需詳細資訊,請參閱ValueSerializer。

給繼承者的注意事項

可以直接跳過這個方法,自己設定轉換要求。

關於用於支援 XAML 及自訂型別的型別轉換器的實作模式,請參見 XAML 型別轉換器概述。

另請參閱

適用於