ImageFormatConverter.ConvertTo Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Package:

System.Drawing.Common v9.0.0-rc.2.24474.1

Source:

ImageFormatConverter.cs

Converts the specified object 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 for a particular culture.

value

Object

The object to convert.

destinationType

Type

The type to convert the object to.

Returns

Object

The converted object.

Exceptions

NotSupportedException

The conversion cannot be completed.

ArgumentNullException

destinationType is null.

Remarks

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.