DesignerSerializationManager.CreateInstance Method

Reference

Definition

Namespace:: System.ComponentModel.Design.Serialization

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Creates an instance of a type.

protected:
 virtual System::Object ^ CreateInstance(Type ^ type, System::Collections::ICollection ^ arguments, System::String ^ name, bool addToContainer);

protected virtual object CreateInstance (Type type, System.Collections.ICollection arguments, string name, bool addToContainer);

protected virtual object CreateInstance (Type type, System.Collections.ICollection? arguments, string? name, bool addToContainer);

abstract member CreateInstance : Type * System.Collections.ICollection * string * bool -> obj
override this.CreateInstance : Type * System.Collections.ICollection * string * bool -> obj

Protected Overridable Function CreateInstance (type As Type, arguments As ICollection, name As String, addToContainer As Boolean) As Object

Parameters

type: Type

The type to create an instance of.

arguments: ICollection

The parameters of the type's constructor. This can be null or an empty collection to invoke the parameterless constructor.

name: String

A name to give the object. If null, the object will not be given a name, unless the object is added to a container and the container gives the object a name.

addToContainer: Boolean

true to add the object to the container if the object implements IComponent; otherwise, false.

Returns

Object

A new instance of the type specified by type.

Exceptions

SerializationException

type does not have a constructor that takes parameters contained in arguments.

Remarks

This method is called by serializers when they attempt to create an instance of a type. The default implementation creates a new instance of the type, or it may return an existing instance depending on the values of the PreserveNames and RecycleInstances properties. The CreateInstance method uses reflection to create instances and will perform some generic IConvertible transformations on parameters to find a matching constructor.

Applies to