ConstructorInfo::Invoke Method (array<Object^>^)
Invokes the constructor reflected by the instance that has the specified parameters, providing default values for the parameters not commonly used.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- parameters
-
Type:
array<System::Object^>^
An array of values that matches the number, order and type (under the constraints of the default binder) of the parameters for this constructor. If this constructor takes no parameters, then use either an array with zero elements or null, as in Object[] parameters = new Object[0]. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is null. For value-type elements, this value is 0, 0.0, or false, depending on the specific element type.
| Exception | Condition | ||
|---|---|---|---|
| MemberAccessException | The class is abstract. -or- The constructor is a class initializer. | ||
| MethodAccessException |
The constructor is private or protected, and the caller lacks ReflectionPermissionFlag::MemberAccess. | ||
| ArgumentException | The parameters array does not contain values that match the types accepted by this constructor. | ||
| TargetInvocationException | The invoked constructor throws an exception. | ||
| TargetParameterCountException | An incorrect number of parameters was passed. | ||
| NotSupportedException | Creation of TypedReference, ArgIterator, and RuntimeArgumentHandle types is not supported. | ||
| SecurityException | The caller does not have the necessary code access permission. |
The number, type, and order of elements in the parameters array should be identical to the number, type, and order of parameters for the constructor reflected by this instance. Before calling the constructor, Invoke ensures that the caller has access permission and verifies that the parameters are valid.
Access restrictions are ignored for fully trusted code. That is, private constructors, methods, fields, and properties can be accessed and invoked using reflection whenever the code is fully trusted.
Note |
|---|
To create an instance of a value type that has no instance constructors, use the CreateInstance method. |
This method is a convenience method for the following overloaded version, using default values. This method cannot be overridden.
Note |
|---|
Starting with the .NET Framework 2.0 Service Pack 1, this method can be used to access non-public members if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag::RestrictedMemberAccess flag and if the grant set of the non-public members is restricted to the caller’s grant set, or a subset thereof. (See Security Considerations for Reflection.) To use this functionality, your application should target the .NET Framework 3.5 or later. |
for accessing non-public members when the grant set of the non-public members is restricted to the caller's grant set, or a subset thereof. Associated enumeration: ReflectionPermissionFlag::RestrictedMemberAccess
for accessing non-public members regardless of their grant set. Associated enumeration: ReflectionPermissionFlag::MemberAccess
when invoked late-bound through mechanisms such as Type::InvokeMember. Associated enumeration: ReflectionPermissionFlag::MemberAccess.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
