TypeConverter.ConvertTo 方法
本文內容
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將給定的值物件轉換為指定的類型。
ConvertTo(Object, Type) |
會使用引數,將指定值物件轉換成指定型別。 |
ConvertTo(ITypeDescriptorContext, CultureInfo, 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 物件。
適用於
.NET 9 及其他版本
產品 | 版本 |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
使用指定的內容和文化特性資訊,將給定的值物件轉換為指定的類型。
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 的型別轉換器概觀。
另請參閱
適用於
.NET 9 及其他版本
產品 | 版本 |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |