TypeConverter.ConvertTo TypeConverter.ConvertTo TypeConverter.ConvertTo TypeConverter.ConvertTo Method

定義

指定した値オブジェクトを、指定した型に変換します。Converts the given value object to the specified type.

オーバーロード

ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type)

引数を使用して、指定した値オブジェクトを、指定した型に変換します。Converts the given value object to the specified type, using the arguments.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

指定したコンテキストとカルチャ情報を使用して、指定した値オブジェクトを、指定した型に変換します。Converts the given value object to the specified type, using the specified context and culture information.

ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type)

引数を使用して、指定した値オブジェクトを、指定した型に変換します。Converts the given value object to the specified type, using the arguments.

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 Object Object

変換対象の ObjectThe Object to convert.

destinationType
Type Type Type Type

value パラメーターの変換後の TypeThe Type to convert the value parameter to.

戻り値

変換後の値を表す ObjectAn Object that represents the converted value.

例外

destinationType パラメーターが null です。The destinationType parameter is null.

変換を実行できません。The conversion cannot be performed.

注釈

最も一般的な型との間の変換には、文字列オブジェクトです。The most common type to convert to and from is a string object. この実装を呼び出すToStringオブジェクトの変換先の型が文字列の場合と、オブジェクトが有効な場合。This implementation calls ToString on the object, if the object is valid and if the destination type is a string.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

指定したコンテキストとカルチャ情報を使用して、指定した値オブジェクトを、指定した型に変換します。Converts the given value object to the specified type, using the specified context and culture information.

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 ITypeDescriptorContext ITypeDescriptorContext

書式指定コンテキストを提供する ITypeDescriptorContextAn ITypeDescriptorContext that provides a format context.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

CultureInfoA CultureInfo. null を渡すと、現在のカルチャが使用されます。If null is passed, the current culture is assumed.

value
Object Object Object Object

変換対象の ObjectThe Object to convert.

destinationType
Type Type Type Type

value パラメーターの変換後の TypeThe Type to convert the value parameter to.

戻り値

変換後の値を表す ObjectAn Object that represents the converted value.

例外

destinationType パラメーターが null です。The destinationType parameter is null.

変換を実行できません。The conversion cannot be performed.

注釈

変換前後の型として最もよく使用されるのは文字列オブジェクトです。The most common types to convert are to and from a string object. この実装を呼び出すToStringオブジェクトの変換先の型が文字列の場合と、オブジェクトが有効な場合。This implementation calls ToString on the object if the object is valid and if the destination type is a string.

コンバーターが呼び出される環境に関する追加情報を抽出するには、context パラメーターを使用します。Use the context parameter to extract additional information about the environment from which this converter is invoked. このパラメーターはnull、常にチェックします。This parameter can be null, so always check it. また、コンテキスト オブジェクトのプロパティも null を返す場合があります。Also, properties on the context object can return null.

通常、XAML の型変換の動作をサポートするカスタム型の作成者が実装をTypeConverterをサポートするクラスConvertFrom文字列から動作します。Custom type authors that intend to support a type conversion behavior for XAML typically implement a TypeConverter class that supports ConvertFrom behavior from a string. これらの型コンバーター実装することもConvertToを XAML にシリアル化をサポートします。These type converters might also implement ConvertTo to support serialization back to XAML.

XAML シリアル化のシナリオによっては適切に対処できないTypeConverterだけです。Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. このような場合でも定義するために必要な場合があります、ValueSerializerによって処理される場合はそれ以外の場合、シリアル化のケースを処理するConvertToします。In these cases, it may be necessary to also define a ValueSerializer that handles the serialization cases that would otherwise be handled by ConvertTo. 詳細については、「ValueSerializer」を参照してください。For more information, see ValueSerializer.

注意 (継承者)

独自の変換要件を指定するには、このメソッドをオーバーライドします。Override this method to provide your own conversion requirements.

XAML とカスタムの型をサポートするために使用される型コンバーターの実装パターンを参照してください。 XAML の概要の型コンバーターのします。For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

こちらもご覧ください

適用対象