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 。 これらの型コンバーターは、XAML へのシリアル化をサポートするために実装 ConvertTo される場合もあります。
一部の XAML シリアル化シナリオでは、単独では TypeConverter 適切に対処できません。 このような場合は、それ以外の場合に処理されるシリアル化ケースを処理する a も定義 ValueSerializer する必要があります ConvertTo。 詳細については、「ValueSerializer」を参照してください。
注意 (継承者)
独自の変換要件を指定するには、このメソッドをオーバーライドします。
XAML とカスタム型をサポートするために使用される型コンバーターの実装パターンについては、「XAML の 概要の型コンバーター」を参照してください。