TypeConverter.ConvertTo 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將給定的值物件轉換為指定的類型。
多載
| ConvertTo(Object, Type) |
會使用引數,將指定值物件轉換成指定型別。 |
| ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) |
使用指定的內容和文化特性資訊,將給定的值物件轉換為指定的類型。 |
ConvertTo(Object, Type)
會使用引數,將指定值物件轉換成指定型別。
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
參數
傳回
Object,代表轉換過的值。
例外狀況
destinationType 參數為 null。
無法執行轉換作業。
備註
要轉換成和傳回的最常見型別是字串物件。 如果物件有效,而且目的型別為字串,則此實作會呼叫 ToString 物件。
適用於
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)
使用指定的內容和文化特性資訊,將給定的值物件轉換為指定的類型。
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,則會採用目前的文化特性。
傳回
Object,代表轉換過的值。
例外狀況
destinationType 參數為 null。
無法執行轉換作業。
備註
最常用於轉換的型別為相互轉換字串物件。 如果物件有效且目的類型為字串,則此實作會在 物件上呼叫 ToString 。
context 參數可以用於擷取環境的其他資訊,而這個轉換子就是從該環境叫用的。 此參數可以是 null,因此請一律檢查它。 甚至,內容物件上的屬性可能會傳回 null。
想要支援 XAML 類型轉換行為的自訂類型作者,通常會實 TypeConverter 作支援 ConvertFrom 字串行為的類別。 這些類型轉換器也可能實 ConvertTo 作以支援串行化回 XAML。
某些 XAML 串行化案例無法單獨適當地處理 TypeConverter 。 在這些情況下,可能也需要定義 , ValueSerializer 以處理 會由 ConvertTo處理的串行化案例。 如需詳細資訊,請參閱ValueSerializer。
給繼承者的注意事項
請覆寫這個方法以提供您自己的轉換需求。
如需用於支援 XAML 和自定義類型之類型轉換器的實作模式,請參閱 XAML 的型別轉換器概觀。