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.

ImageFormatConverter.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 specified object to the specified type.

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

public override object ConvertTo(
	ITypeDescriptorContext context,
	CultureInfo culture,
	object value,
	Type destinationType


Type: System.ComponentModel.ITypeDescriptorContext

A formatter context. This object can be used to get more information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null.

Type: System.Globalization.CultureInfo

A CultureInfo object that specifies formatting conventions for a particular culture.

Type: System.Object

The object to convert.

Type: System.Type

The type to convert the object to.

Return Value

Type: System.Object

The converted object.

Exception Condition

The conversion cannot be completed.


destinationType is null.

The ImageFormatConverter converts to and from known image formats, as specified in the ImageFormat class.

The most common type conversion is to and from a string type. The default implementation calls the ToString method of the object if the object is valid and if the destination type is string. If this method cannot convert the specified object to the specified destination type, it throws a NotSupportedException exception.

.NET Framework
Available since 1.1
Return to top
© 2018 Microsoft