.NET Framework Class Library
TypeConverterConvertTo Method (ITypeDescriptorContext, CultureInfo, Object, Type)

Converts the given value object to the specified type, using the specified context and culture information.

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)
Syntax
Public Overridable Function ConvertTo ( _
	context As [%$TOPIC/627w8xaa_en-us_VS_110_1_0_0_0_0%], _
	culture As [%$TOPIC/627w8xaa_en-us_VS_110_1_0_0_0_1%], _
	value As [%$TOPIC/627w8xaa_en-us_VS_110_1_0_0_0_2%], _
	destinationType As [%$TOPIC/627w8xaa_en-us_VS_110_1_0_0_0_3%] _
) As [%$TOPIC/627w8xaa_en-us_VS_110_1_0_0_0_4%]
public virtual [%$TOPIC/627w8xaa_en-us_VS_110_1_0_1_0_0%] ConvertTo(
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_1_0_1%] context,
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_1_0_2%] culture,
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_1_0_3%] value,
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_1_0_4%] destinationType
)
public:
virtual [%$TOPIC/627w8xaa_en-us_VS_110_1_0_2_0_0%]^ ConvertTo(
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_2_0_1%]^ context, 
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_2_0_2%]^ culture, 
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_2_0_3%]^ value, 
	[%$TOPIC/627w8xaa_en-us_VS_110_1_0_2_0_4%]^ destinationType
)
abstract ConvertTo : 
        context:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_0%] * 
        culture:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_1%] * 
        value:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_2%] * 
        destinationType:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_3%] -> [%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_4%]  
override ConvertTo : 
        context:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_5%] * 
        culture:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_6%] * 
        value:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_7%] * 
        destinationType:[%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_8%] -> [%$TOPIC/627w8xaa_en-us_VS_110_1_0_3_0_9%]

Parameters

context
Type: System.ComponentModelITypeDescriptorContext

An ITypeDescriptorContext that provides a format context.

culture
Type: System.GlobalizationCultureInfo

A CultureInfo. If is passed, the current culture is assumed.

value
Type: SystemObject

The Object to convert.

destinationType
Type: SystemType

The Type to convert the value parameter to.

Return Value

Type: SystemObject
An Object that represents the converted value.
Exceptions
ExceptionCondition
ArgumentNullException

The destinationType parameter is .

NotSupportedException

The conversion cannot be performed.

Remarks

The most common types to convert are to and from a string object. This implementation calls ToString on the object if the object is valid and if the destination type is a string.

Use the context parameter to extract additional information about the environment from which this converter is invoked. This parameter can be , so always check it. Also, properties on the context object can return .

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. These type converters might also implement ConvertTo to support serialization back to XAML.

Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. In these cases, it may be necessary to also define a ValueSerializer that handles the serialization cases that would otherwise be handled by ConvertTo. For more information, see ValueSerializer.

Notes to Inheritors

Override this method to provide your own conversion requirements.

For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

Version Information

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1
Platforms

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.