TypeConverter.ConvertTo メソッド

定義

名前空間:

System.ComponentModel

アセンブリ:

netstandard.dll, 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

Type パラメーターを変換するvalue。

返品

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

Type パラメーターを変換するvalue。

返品

Object

変換後の値を表す Object 。

例外

ArgumentNullException

destinationType パラメーターはnull。

NotSupportedException

変換を実行できません。

注釈

変換する最も一般的な型は、文字列オブジェクトとの間です。 この実装では、オブジェクトが有効な場合、および変換先の型が文字列の場合に、オブジェクトの ToString を呼び出します。

context パラメーターを使用して、このコンバーターの呼び出し元の環境に関する追加情報を抽出します。 このパラメーターは nullできるため、常に確認してください。 また、コンテキスト オブジェクトのプロパティは、 nullを返すことができます。

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

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

注意 (継承者)

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

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

こちらもご覧ください

• ITypeDescriptorContext
• XAML の型コンバーターの概要