This documentation is archived and is not being maintained.

TypeConverter.CreateInstance Method (ITypeDescriptorContext, IDictionary)

Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.

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

virtual Object^ CreateInstance (
	ITypeDescriptorContext^ context, 
	IDictionary^ propertyValues
public Object CreateInstance (
	ITypeDescriptorContext context, 
	IDictionary propertyValues
public function CreateInstance (
	context : ITypeDescriptorContext, 
	propertyValues : IDictionary
) : Object
Not applicable.



An ITypeDescriptorContext that provides a format context.


An IDictionary of new property values.

Return Value

An Object representing the given IDictionary, or a null reference (Nothing in Visual Basic) if the object cannot be created. This method always returns a null reference (Nothing in Visual Basic).

Use this method for objects that are immutable, but for which you want to provide changeable properties.

Notes to Inheritors: Override this method if the type you want to convert must re-create the object to change its value. Use the context parameter to extract additional information about the environment from which this converter is invoked. This parameter can be a null reference (Nothing in Visual Basic), so always check it. Also, properties on the context object can return a null reference (Nothing in Visual Basic). The dictionary provided by the propertyValues parameter has a series of name/value pairs, one for each property returned from GetProperties.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0