Export (0) Print
Expand All

ConstructorInfo Class

Discovers the attributes of a class constructor and provides access to constructor metadata.

Namespace:  System.Reflection
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public abstract class ConstructorInfo : MethodBase, 
	_ConstructorInfo

The ConstructorInfo type exposes the following members.

  NameDescription
Protected methodSupported by the XNA FrameworkConstructorInfoInitializes a new instance of the ConstructorInfo class.
Top

  NameDescription
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsAttributesGets the attributes associated with this method. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsCallingConventionGets a value indicating the calling conventions for this method. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsContainsGenericParametersGets a value indicating whether the generic method contains unassigned generic type parameters. (Inherited from MethodBase.)
Public propertySupported in .NET for Windows Store appsCustomAttributesGets a collection that contains this member's custom attributes. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsDeclaringTypeGets the class that declares this member. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsAbstractGets a value indicating whether the method is abstract. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsAssemblyGets a value indicating whether the potential visibility of this method or constructor is described by MethodAttributes.Assembly; that is, the method or constructor is visible at most to other types in the same assembly, and is not visible to derived types outside the assembly. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsConstructorGets a value indicating whether the method is a constructor. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFamilyGets a value indicating whether the visibility of this method or constructor is described by MethodAttributes.Family; that is, the method or constructor is visible only within its class and derived classes. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFamilyAndAssemblyGets a value indicating whether the visibility of this method or constructor is described by MethodAttributes.FamANDAssem; that is, the method or constructor can be called by derived classes, but only if they are in the same assembly. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFamilyOrAssemblyGets a value indicating whether the potential visibility of this method or constructor is described by MethodAttributes.FamORAssem; that is, the method or constructor can be called by derived classes wherever they are, and by classes in the same assembly. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsFinalGets a value indicating whether this method is final. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsGenericMethodGets a value indicating whether the method is generic. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsGenericMethodDefinitionGets a value indicating whether the method is a generic method definition. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsHideBySigGets a value indicating whether only a member of the same kind with exactly the same signature is hidden in the derived class. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsPrivateGets a value indicating whether this member is private. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsPublicGets a value indicating whether this is a public method. (Inherited from MethodBase.)
Public propertyIsSecurityCriticalGets a value that indicates whether the current method or constructor is security-critical or security-safe-critical at the current trust level, and therefore can perform critical operations. (Inherited from MethodBase.)
Public propertyIsSecuritySafeCriticalGets a value that indicates whether the current method or constructor is security-safe-critical at the current trust level; that is, whether it can perform critical operations and can be accessed by transparent code. (Inherited from MethodBase.)
Public propertyIsSecurityTransparentGets a value that indicates whether the current method or constructor is transparent at the current trust level, and therefore cannot perform critical operations. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsSpecialNameGets a value indicating whether this method has a special name. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsStaticGets a value indicating whether the method is static. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsIsVirtualGets a value indicating whether the method is virtual. (Inherited from MethodBase.)
Public propertySupported by the XNA FrameworkMemberTypeGets a MemberTypes value indicating that this member is a constructor. (Overrides MemberInfo.MemberType.)
Public propertyMetadataTokenGets a value that identifies a metadata element. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryMethodHandleGets a handle to the internal metadata representation of a method. (Inherited from MethodBase.)
Public propertySupported in .NET for Windows Store appsMethodImplementationFlagsGets the MethodImplAttributes flags that specify the attributes of a method implementation. (Inherited from MethodBase.)
Public propertySupported in .NET for Windows Store appsModuleGets the module in which the type that declares the member represented by the current MemberInfo is defined. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsNameGets the name of the current member. (Inherited from MemberInfo.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryReflectedTypeGets the class object that was used to obtain this instance of MemberInfo. (Inherited from MemberInfo.)
Top

  NameDescription
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryEqualsReturns a value that indicates whether this instance is equal to a specified object. (Overrides MethodBase.Equals(Object).)

In XNA Framework 3.0, this member is inherited from Object.Equals(Object).


In Portable Class Library Portable Class Library, this member is inherited from Object.Equals(Object).
Protected methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetCustomAttributes(Boolean)When overridden in a derived class, returns an array of all custom attributes applied to this member. (Inherited from MemberInfo.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetCustomAttributes(Type, Boolean)When overridden in a derived class, returns an array of custom attributes applied to this member and identified by Type. (Inherited from MemberInfo.)
Public methodGetCustomAttributesDataReturns a list of CustomAttributeData objects representing data about the attributes that have been applied to the target member. (Inherited from MemberInfo.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetGenericArgumentsReturns an array of Type objects that represent the type arguments of a generic method or the type parameters of a generic method definition. (Inherited from MethodBase.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetHashCodeReturns the hash code for this instance. (Overrides MethodBase.GetHashCode().)

In XNA Framework 3.0, this member is inherited from Object.GetHashCode().


In Portable Class Library Portable Class Library, this member is inherited from Object.GetHashCode().
Public methodGetMethodBodyWhen overridden in a derived class, gets a MethodBody object that provides access to the MSIL stream, local variables, and exceptions for the current method. (Inherited from MethodBase.)
Public methodGetMethodImplementationFlagsWhen overridden in a derived class, returns the MethodImplAttributes flags. (Inherited from MethodBase.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetParametersWhen overridden in a derived class, gets the parameters of the specified method or constructor. (Inherited from MethodBase.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsInvoke(Object[])Invokes the constructor reflected by the instance that has the specified parameters, providing default values for the parameters not commonly used.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsInvoke(Object, Object[])Invokes the method or constructor represented by the current instance, using the specified parameters. (Inherited from MethodBase.)
Public methodSupported by the XNA FrameworkInvoke(BindingFlags, Binder, Object[], CultureInfo)When implemented in a derived class, invokes the constructor reflected by this ConstructorInfo with the specified arguments, under the constraints of the specified Binder.
Public methodSupported by the XNA FrameworkInvoke(Object, BindingFlags, Binder, Object[], CultureInfo)When overridden in a derived class, invokes the reflected method or constructor with the given parameters. (Inherited from MethodBase.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryIsDefinedWhen overridden in a derived class, indicates whether one or more attributes of the specified type or of its derived types is applied to this member. (Inherited from MemberInfo.)
Protected methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public operatorStatic memberEqualityIndicates whether two ConstructorInfo objects are equal.
Public operatorStatic memberInequalityIndicates whether two ConstructorInfo objects are not equal.
Top

  NameDescription
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute(Type)Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute(Type, Boolean)Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute<T>()Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttribute<T>(Boolean)Overloaded. Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes()Overloaded. Retrieves a collection of custom attributes that are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Boolean)Overloaded. Retrieves a collection of custom attributes that are applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Type)Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes(Type, Boolean)Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes<T>()Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsGetCustomAttributes<T>(Boolean)Overloaded. Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsIsDefined(Type)Overloaded. Indicates whether custom attributes of a specified type are applied to a specified member. (Defined by CustomAttributeExtensions.)
Public Extension MethodSupported in .NET for Windows Store appsIsDefined(Type, Boolean)Overloaded. Indicates whether custom attributes of a specified type are applied to a specified member, and, optionally, applied to its ancestors. (Defined by CustomAttributeExtensions.)
Top

  NameDescription
Public fieldStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsConstructorNameRepresents the name of the class constructor method as it is stored in metadata. This name is always ".ctor". This field is read-only.
Public fieldStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsTypeConstructorNameRepresents the name of the type constructor method as it is stored in metadata. This name is always ".cctor". This property is read-only.
Top

  NameDescription
Explicit interface implemetationPrivate method_ConstructorInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers.
Explicit interface implemetationPrivate method_ConstructorInfo.GetTypeGets a Type object representing the ConstructorInfo type.
Explicit interface implemetationPrivate method_ConstructorInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface.
Explicit interface implemetationPrivate method_ConstructorInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1).
Explicit interface implemetationPrivate method_ConstructorInfo.InvokeProvides access to properties and methods exposed by an object.
Explicit interface implemetationPrivate method_ConstructorInfo.Invoke_2Provides COM objects with version-independent access to the MethodBase.Invoke(Object, BindingFlags, Binder, Object[], CultureInfo) method.
Explicit interface implemetationPrivate method_ConstructorInfo.Invoke_3Provides COM objects with version-independent access to the MethodBase.Invoke(Object, Object[]) method.
Explicit interface implemetationPrivate method_ConstructorInfo.Invoke_4Provides COM objects with version-independent access to the ConstructorInfo.Invoke(BindingFlags, Binder, Object[], CultureInfo) method.
Explicit interface implemetationPrivate method_ConstructorInfo.Invoke_5Provides COM objects with version-independent access to the ConstructorInfo.Invoke(Object[]) method.
Explicit interface implemetationPrivate method_MemberInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeGets a Type object representing the MemberInfo class. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.InvokeProvides access to properties and methods exposed by an object. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MethodBase.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from MethodBase.)
Explicit interface implemetationPrivate method_MethodBase.GetTypeFor a description of this member, see _MethodBase.GetType. (Inherited from MethodBase.)
Explicit interface implemetationPrivate method_MethodBase.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from MethodBase.)
Explicit interface implemetationPrivate method_MethodBase.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from MethodBase.)
Explicit interface implemetationPrivate method_MethodBase.InvokeProvides access to properties and methods exposed by an object. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsAbstractFor a description of this member, see _MethodBase.IsAbstract. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsAssemblyFor a description of this member, see _MethodBase.IsAssembly. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsConstructorFor a description of this member, see _MethodBase.IsConstructor. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsFamilyFor a description of this member, see _MethodBase.IsFamily. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsFamilyAndAssemblyFor a description of this member, see _MethodBase.IsFamilyAndAssembly. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsFamilyOrAssemblyFor a description of this member, see _MethodBase.IsFamilyOrAssembly. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsFinalFor a description of this member, see _MethodBase.IsFinal. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsHideBySigFor a description of this member, see _MethodBase.IsHideBySig. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsPrivateFor a description of this member, see _MethodBase.IsPrivate. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsPublicFor a description of this member, see _MethodBase.IsPublic. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsSpecialNameFor a description of this member, see _MethodBase.IsSpecialName. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsStaticFor a description of this member, see _MethodBase.IsStatic. (Inherited from MethodBase.)
Explicit interface implemetationPrivate property_MethodBase.IsVirtualFor a description of this member, see _MethodBase.IsVirtual. (Inherited from MethodBase.)
Top

ConstructorInfo is used to discover the attributes of a constructor as well as to invoke a constructor. Objects are created by calling Invoke on a ConstructorInfo returned by either the GetConstructors or GetConstructor method of a Type object.

NoteNote

ConstructorInfo inherits from MethodBase several members, such as IsGenericMethod, that can be used to examine generic methods. In the .NET Framework version 2.0 constructors cannot be generic, so these members return false or null.

Notes to Inheritors

When you inherit from ConstructorInfo, you must override the following member overload: Invoke(BindingFlags, Binder, Object[], CultureInfo).

The following example uses ConstructorInfo with GetConstructor and BindingFlags to find the constructors that match the specified search criteria.

using System;
using System.Reflection;
using System.Security;

public class MyClass1
{
    public MyClass1(int i){}
    public static void Main()
    {
        try
        {
            Type  myType = typeof(MyClass1);
            Type[] types = new Type[1];
            types[0] = typeof(int);
            // Get the public instance constructor that takes an integer parameter.
            ConstructorInfo constructorInfoObj = myType.GetConstructor(
                BindingFlags.Instance | BindingFlags.Public, null,
                CallingConventions.HasThis, types, null);
            if(constructorInfoObj != null)
            {
                Console.WriteLine("The constructor of MyClass1 that is a public " +
                    "instance method and takes an integer as a parameter is: ");
                Console.WriteLine(constructorInfoObj.ToString());
            }
            else
            {
                Console.WriteLine("The constructor of MyClass1 that is a public instance " +
                    "method and takes an integer as a parameter is not available.");
            }
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException: " + e.Message);
        }
        catch(ArgumentException e)
        {
            Console.WriteLine("ArgumentException: " + e.Message);
        }
        catch(SecurityException e)
        {
            Console.WriteLine("SecurityException: " + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception: " + e.Message);
        }
    }
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

This type is thread safe.

Show:
© 2014 Microsoft