Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TypeConverter::ConvertTo Method (ITypeDescriptorContext^, CultureInfo^, Object^, Type^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)

virtual Object^ ConvertTo(
	ITypeDescriptorContext^ context,
	CultureInfo^ culture,
	Object^ value,
	Type^ destinationType


Type: System.ComponentModel::ITypeDescriptorContext^

An ITypeDescriptorContext that provides a format context.

Type: System.Globalization::CultureInfo^

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

Type: System::Object^

The Object to convert.

Type: System::Type^

The Type to convert the value parameter to.

Return Value

Type: System::Object^

An Object that represents the converted value.

Exception Condition

The destinationType parameter is null.


The conversion cannot be performed.

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 null, so always check it. Also, properties on the context object can return null.

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.

.NET Framework
Available since 1.1
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
© 2018 Microsoft