ImageConverter.ConvertTo Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Converts an Image (or an object that can be cast to an Image) to the specified type.

public:
 override System::Object ^ ConvertTo(System::ComponentModel::ITypeDescriptorContext ^ context, System::Globalization::CultureInfo ^ culture, System::Object ^ value, Type ^ destinationType);

public override object ConvertTo (System.ComponentModel.ITypeDescriptorContext? context, System.Globalization.CultureInfo? culture, object? value, Type destinationType);

override this.ConvertTo : System.ComponentModel.ITypeDescriptorContext * System.Globalization.CultureInfo * obj * Type -> obj

Public Overrides Function ConvertTo (context As ITypeDescriptorContext, culture As CultureInfo, value As Object, destinationType As Type) As Object

Parameters

context

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.

culture

CultureInfo

A CultureInfo object that specifies formatting conventions used by a particular culture.

value

Object

The Image to convert.

destinationType

Type

The Type to convert the Image to.

Returns

Object

This method returns the converted object.

Exceptions

NotSupportedException

The conversion cannot be completed.

Remarks

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 destination type, it throws a NotSupportedException exception.