TypeConverter.ConvertTo メソッド

定義

指定した値オブジェクトを指定した型に変換します。

オーバーロード

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

パラメーター

value
Object

変換対象の Object

destinationType
Type

value パラメーターの変換後の Type

戻り値

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

CultureInfonull を渡すと、現在のカルチャが使用されます。

value
Object

変換対象の Object

destinationType
Type

value パラメーターの変換後の Type

戻り値

Object

変換後の値を表す Object

例外

destinationType パラメーターが null です。

変換を実行できません。

注釈

変換前後の型として最もよく使用されるのは文字列オブジェクトです。 この実装では、オブジェクトが有効な場合、および変換先の型が文字列の場合、オブジェクトを呼び出 ToString します。

コンバーターが呼び出される環境に関する追加情報を抽出するには、context パラメーターを使用します。 このパラメーターは、 null常にチェックできます。 また、コンテキスト オブジェクトのプロパティも null を返す場合があります。

XAML の型変換動作をサポートするカスタム型作成者は、通常、文字列からの動作を TypeConverter サポートするクラスを実装します ConvertFrom 。 これらの型コンバーターは、XAML へのシリアル化をサポートするために実装 ConvertTo される場合もあります。

一部の XAML シリアル化シナリオでは、単独では TypeConverter 適切に対処できません。 このような場合は、それ以外の場合に処理されるシリアル化ケースを処理する a も定義 ValueSerializer する必要があります ConvertTo。 詳細については、「ValueSerializer」を参照してください。

注意 (継承者)

独自の変換要件を指定するには、このメソッドをオーバーライドします。

XAML とカスタム型をサポートするために使用される型コンバーターの実装パターンについては、「XAML の 概要の型コンバーター」を参照してください。

こちらもご覧ください

適用対象