Activator.CreateInstance Method (Type, BindingFlags, Binder, Object[], CultureInfo, Object[])
Creates an instance of the specified type using the constructor that best matches the specified parameters.
[Visual Basic]
Overloads Public Shared Function CreateInstance( _
ByVal type As Type, _
ByVal bindingAttr As BindingFlags, _
ByVal binder As Binder, _
ByVal args() As Object, _
ByVal culture As CultureInfo, _
ByVal activationAttributes() As Object _
) As Object
[C#]
public static object CreateInstance(
Type type,
BindingFlags bindingAttr,
Binder binder,
object[] args,
CultureInfo culture,
object[] activationAttributes
);
[C++]
public: static Object* CreateInstance(
Type* type,
BindingFlags bindingAttr,
Binder* binder,
Object* args __gc[],
CultureInfo* culture,
Object* activationAttributes __gc[]
);
[JScript]
public static function CreateInstance(
type : Type,
bindingAttr : BindingFlags,
binder : Binder,
args : Object[],
culture : CultureInfo,
activationAttributes : Object[]
) : Object;
Parameters
- type
- The type of object to create.
- bindingAttr
- A combination of zero or more bit flags that affect the search for the type constructor. If bindingAttr is zero, a case-sensitive search for public constructors is conducted.
- binder
- An object that uses bindingAttr and args to seek and identify the type constructor. If binder is a null reference (Nothing in Visual Basic), the default binder is used.
- args
- An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or a null reference (Nothing in Visual Basic), the constructor that takes no parameters (the default constructor) is invoked.
- culture
- Culture-specific information that governs the coercion of args to the formal types declared for the type constructor. If culture is a null reference (Nothing in Visual Basic), the CultureInfo for the current thread is used.
- activationAttributes
- An array of one or more attributes that can participate in activation.
Return Value
A reference to the newly created object.
Exceptions
Remarks
The constructor to be invoked must be accessible and provide the most specific match with the specified argument list under the constraints of the specified binder and binding attributes.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
.NET Framework Security:
- SecurityPermission for the ability to call unmanaged code when creating an instance of a delegate. Associated enumeration: SecurityPermissionFlag/UnmanagedCode
- ReflectionPermission for the ability to invoke operations on all type members. Associated enumeration: ReflectionPermissionFlag/MemberAccess
See Also
Activator Class | Activator Members | System Namespace | Activator.CreateInstance Overload List
