System.Reflection.Emit.TypeBuilder Class

Summary

Defines and creates new instances of classes during runtime.

C# Syntax:

public sealed class TypeBuilder : Type

Reflection Emit is thread-safe when using assemblies that were created with the AppDomain.DefineDynamicAssembly method with the Boolean parameter isSynchronized set to true.

TypeBuilder is the root class used to control the creation of dynamic classes in the runtime.TypeBuilder provides a set of routines that are used to define classes, add methods and fields, and create the class inside the runtime. A new TypeBuilder can be created from a dynamic module.

To retrieve a parametrized unfinished type, use ModuleBuilder.GetType. For example, given an unfinished type "mytype", use ModuleBuilder.GetType to retrieve the type for "mytype[]". ModuleBuilder.GetType cannot be used to retrieve parametrized unfinished types.

System.Reflection.Emit Namespace

System.Reflection.Emit.TypeBuilder Member List:

Public Fields

UnspecifiedTypeSize

Represents that total size for the type is not specified.

Public Properties

Assembly	Read-only Overridden: Retrieves the dynamic assembly that contains this type definition.
AssemblyQualifiedName	Read-only Overridden: Returns the full name of this type qualified by the display name of the assembly.
Attributes (inherited from System.Type)	Read-only See base class member description: System.Type.Attributes Gets the attributes associated with the Type.
BaseType	Read-only Overridden: Retrieves the base type of this type.
DeclaringType	Read-only Overridden: Returns the type that declared this type.
FullName	Read-only Overridden: Retrieves the full path of this type.
GUID	Read-only Overridden: Retrieves the GUID of this type.
HasElementType (inherited from System.Type)	Read-only See base class member description: System.Type.HasElementType Gets a value indicating whether the current Type encompasses or refers to another type; that is, whether the current Type is an array, a pointer, or is passed by reference.
IsAbstract (inherited from System.Type)	Read-only See base class member description: System.Type.IsAbstract Gets a value indicating whether the Type is abstract and must be overridden.
IsAnsiClass (inherited from System.Type)	Read-only See base class member description: System.Type.IsAnsiClass Gets a value indicating whether the string format attribute AnsiClass is selected for the Type.
IsArray (inherited from System.Type)	Read-only See base class member description: System.Type.IsArray Gets a value indicating whether the Type is an array.
IsAutoClass (inherited from System.Type)	Read-only See base class member description: System.Type.IsAutoClass Gets a value indicating whether the string format attribute AutoClass is selected for the Type.
IsAutoLayout (inherited from System.Type)	Read-only See base class member description: System.Type.IsAutoLayout Gets a value indicating whether the class layout attribute AutoLayout is selected for the Type.
IsByRef (inherited from System.Type)	Read-only See base class member description: System.Type.IsByRef Gets a value indicating whether the Type is passed by reference.
IsClass (inherited from System.Type)	Read-only See base class member description: System.Type.IsClass Gets a value indicating whether the Type is a class; that is, not a value type or interface.
IsCOMObject (inherited from System.Type)	Read-only See base class member description: System.Type.IsCOMObject Gets a value indicating whether the Type is a COM object.
IsContextful (inherited from System.Type)	Read-only See base class member description: System.Type.IsContextful Gets a value indicating whether the Type can be hosted in a context.
IsEnum (inherited from System.Type)	Read-only See base class member description: System.Type.IsEnum Gets a value indicating whether the current Type represents an enumeration.
IsExplicitLayout (inherited from System.Type)	Read-only See base class member description: System.Type.IsExplicitLayout Gets a value indicating whether the class layout attribute ExplicitLayout is selected for the Type.
IsImport (inherited from System.Type)	Read-only See base class member description: System.Type.IsImport Gets a value indicating whether the Type was imported from another class.
IsInterface (inherited from System.Type)	Read-only See base class member description: System.Type.IsInterface Gets a value indicating whether the Type is an interface; that is, not a class or a value type.
IsLayoutSequential (inherited from System.Type)	Read-only See base class member description: System.Type.IsLayoutSequential Gets a value indicating whether the class layout attribute SequentialLayout is selected for the Type.
IsMarshalByRef (inherited from System.Type)	Read-only See base class member description: System.Type.IsMarshalByRef Gets a value indicating whether the Type is marshaled by reference.
IsNestedAssembly (inherited from System.Type)	Read-only See base class member description: System.Type.IsNestedAssembly Gets a value indicating whether the Type is nested and visible only within its own assembly.
IsNestedFamANDAssem (inherited from System.Type)	Read-only See base class member description: System.Type.IsNestedFamANDAssem Gets a value indicating whether the Type is nested and visible only to classes that belong to both its own family and its own assembly.
IsNestedFamily (inherited from System.Type)	Read-only See base class member description: System.Type.IsNestedFamily Gets a value indicating whether the Type is nested and visible only within its own family.
IsNestedFamORAssem (inherited from System.Type)	Read-only See base class member description: System.Type.IsNestedFamORAssem Gets a value indicating whether the Type is nested and visible only to classes that belong to either its own family or to its own assembly.
IsNestedPrivate (inherited from System.Type)	Read-only See base class member description: System.Type.IsNestedPrivate Gets a value indicating whether the Type is nested and declared private.
IsNestedPublic (inherited from System.Type)	Read-only See base class member description: System.Type.IsNestedPublic Gets a value indicating whether a class is nested and declared public.
IsNotPublic (inherited from System.Type)	Read-only See base class member description: System.Type.IsNotPublic Gets a value indicating whether the top-level Type is not declared public.
IsPointer (inherited from System.Type)	Read-only See base class member description: System.Type.IsPointer Gets a value indicating whether the Type is a pointer.
IsPrimitive (inherited from System.Type)	Read-only See base class member description: System.Type.IsPrimitive Gets a value indicating whether the Type is one of the primitive types.
IsPublic (inherited from System.Type)	Read-only See base class member description: System.Type.IsPublic Gets a value indicating whether the top-level Type is declared public.
IsSealed (inherited from System.Type)	Read-only See base class member description: System.Type.IsSealed Gets a value indicating whether the Type is declared sealed.
IsSerializable (inherited from System.Type)	Read-only See base class member description: System.Type.IsSerializable Gets a value indicating whether the Type is serializable.
IsSpecialName (inherited from System.Type)	Read-only See base class member description: System.Type.IsSpecialName Gets a value indicating whether the Type has a name that requires special handling.
IsUnicodeClass (inherited from System.Type)	Read-only See base class member description: System.Type.IsUnicodeClass Gets a value indicating whether the string format attribute UnicodeClass is selected for the Type.
IsValueType (inherited from System.Type)	Read-only See base class member description: System.Type.IsValueType Gets a value indicating whether the Type is a value type.
MemberType (inherited from System.Type)	Read-only See base class member description: System.Type.MemberType Gets a bitmask indicating the member type.
Module	Read-only Overridden: Retrieves the dynamic module that contains this type definition.
Name	Read-only Overridden: Retrieves the name of this type.
Namespace	Read-only Overridden: Retrieves the namespace where this TypeBuilder is defined.
PackingSize	Read-only Retrieves the packing size of this type.
ReflectedType	Read-only Overridden:
Size	Read-only Retrieves the total size of a type.
TypeHandle	Read-only Overridden: Not supported in dynamic modules.
TypeInitializer (inherited from System.Type)	Read-only See base class member description: System.Type.TypeInitializer Gets the initializer for the Type.
TypeToken	Read-only Returns the type token of this type.
UnderlyingSystemType	Read-only Overridden: Returns the underlying system type for this TypeBuilder.

Public Methods

AddDeclarativeSecurity	Adds declarative security to this type.
AddInterfaceImplementation	Adds an interface that this type implements.
CreateType	Creates a Type object for the class. After defining fields and methods on the class, CreateType is called in order to load its Type object.
DefineConstructor	Adds a new constructor to the class, with the given attributes and signature.
DefineDefaultConstructor	Defines the default constructor. The constructor defined here will simply call the default constructor of the parent.
DefineEvent	Adds a new event to the class, with the given name, attributes and event type.
DefineField	Adds a new field to the class, with the given name, attributes and field type.
DefineInitializedData	Defines initialized data field in the .sdata section of the portable executable (PE) file.
DefineMethod	Overloaded: DefineMethod(string name, MethodAttributes attributes, Type returnType, Type[] parameterTypes) Adds a new method to the class, with the given name and method signature.
DefineMethod	Overloaded: DefineMethod(string name, MethodAttributes attributes, CallingConventions callingConvention, Type returnType, Type[] parameterTypes) Adds a new method to the class, with the given name and method signature.
DefineMethodOverride	Specifies a given method body that implements a given method declaration.
DefineNestedType	Overloaded: DefineNestedType(string name) Defines a nested type given its name.
DefineNestedType	Overloaded: DefineNestedType(string name, TypeAttributes attr) Defines a nested type given its name and attributes.
DefineNestedType	Overloaded: DefineNestedType(string name, TypeAttributes attr, Type parent) Defines a nested type given its name, attributes, and the type that it extends.
DefineNestedType	Overloaded: DefineNestedType(string name, TypeAttributes attr, Type parent, int typeSize) Defines a nested type given its name, attributes, the total size of the type, and the type that it extends.
DefineNestedType	Overloaded: DefineNestedType(string name, TypeAttributes attr, Type parent, PackingSize packSize) Defines a nested type given its name, attributes, the total size of the type, and the type that it extends.
DefineNestedType	Overloaded: DefineNestedType(string name, TypeAttributes attr, Type parent, Type[] interfaces) Defines a nested type given its name, attributes, the type that it extends, and the interfaces that it implements.
DefinePInvokeMethod	Overloaded: DefinePInvokeMethod(string name, string dllName, MethodAttributes attributes, CallingConventions callingConvention, Type returnType, Type[] parameterTypes, CallingConvention nativeCallConv, CharSet nativeCharSet) Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.
DefinePInvokeMethod	Overloaded: DefinePInvokeMethod(string name, string dllName, string entryName, MethodAttributes attributes, CallingConventions callingConvention, Type returnType, Type[] parameterTypes, CallingConvention nativeCallConv, CharSet nativeCharSet) Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.
DefineProperty	Adds a new property to the class, with the given name and property signature.
DefineTypeInitializer	Defines the initializer for this type.
DefineUninitializedData	Defines uninitialized data field in the .sdata section of the portable executable (PE) file.
Equals (inherited from System.Type)	Overloaded: Equals(object o) See base class member description: System.Type.Equals Determines if the underlying system type of the current Type is the same as the underlying system type of the specified Object.
Equals (inherited from System.Type)	Overloaded: Equals(Type o) See base class member description: System.Type.Equals Determines if the underlying system type of the current Type is the same as the underlying system type of the specified Type.
FindInterfaces (inherited from System.Type)	See base class member description: System.Type.FindInterfaces Returns an array of Type objects representing a filtered list of interfaces implemented or inherited by the current Type.
FindMembers (inherited from System.Type)	See base class member description: System.Type.FindMembers Returns a filtered array of MemberInfo objects of the specified member type.
GetArrayRank (inherited from System.Type)	See base class member description: System.Type.GetArrayRank Gets the number of dimensions in an Array.
GetConstructor (inherited from System.Type)	Overloaded: GetConstructor(Type[] types) See base class member description: System.Type.GetConstructor Searches for a public instance constructor whose parameters match the types in the specified array.
GetConstructor (inherited from System.Type)	Overloaded: GetConstructor(BindingFlags bindingAttr, Binder binder, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetConstructor Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints.
GetConstructor (inherited from System.Type)	Overloaded: GetConstructor(BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetConstructor Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.
GetConstructors (inherited from System.Type)	Overloaded: GetConstructors() See base class member description: System.Type.GetConstructors Returns all the public constructors defined for the current Type.
GetConstructors	Overloaded: GetConstructors(BindingFlags bindingAttr) Overridden: Returns an array of ConstructorInfo objects representing the public and non-public constructors defined for this class, as specified.
GetCustomAttributes	Overloaded: GetCustomAttributes(bool inherit) Overridden: Returns all the custom attributes defined for this type.
GetCustomAttributes	Overloaded: GetCustomAttributes(Type attributeType, bool inherit) Overridden: Checks if the specified custom attribute type is defined.
GetDefaultMembers (inherited from System.Type)	See base class member description: System.Type.GetDefaultMembers Searches for the members defined for the current Type whose DefaultMemberAttribute is set.
GetElementType	Overridden: Calling this method always throws NotSupportedException.
GetEvent (inherited from System.Type)	Overloaded: GetEvent(string name) See base class member description: System.Type.GetEvent Returns the EventInfo object representing the specified event.
GetEvent	Overloaded: GetEvent(string name, BindingFlags bindingAttr) Overridden: Returns the event with the specified name.
GetEvents	Overloaded: GetEvents() Overridden: Returns the events for the public events declared or inherited by this type.
GetEvents	Overloaded: GetEvents(BindingFlags bindingAttr) Overridden: Returns the public and non-public events that are declared by this type.
GetField (inherited from System.Type)	Overloaded: GetField(string name) See base class member description: System.Type.GetField Searches for the field with the specified name.
GetField	Overloaded: GetField(string name, BindingFlags bindingAttr) Overridden: Returns the field specified by the given name.
GetFields (inherited from System.Type)	Overloaded: GetFields() See base class member description: System.Type.GetFields Returns all the public fields of the current Type.
GetFields	Overloaded: GetFields(BindingFlags bindingAttr) Overridden: Returns the public and non-public fields that are declared by this type.
GetHashCode (inherited from System.Type)	See base class member description: System.Type.GetHashCode Returns the hash code for this instance.
GetInterface (inherited from System.Type)	Overloaded: GetInterface(string name) See base class member description: System.Type.GetInterface Searches for the interface with the specified name.
GetInterface	Overloaded: GetInterface(string name, bool ignoreCase) Overridden: Returns the interface implemented (directly or indirectly) by this class with the fully-qualified name matching the given interface name.
GetInterfaceMap	Overridden: Returns an interface mapping for the requested interface.
GetInterfaces	Overridden: Returns an array of all the interfaces implemented on this a class and its base classes.
GetMember (inherited from System.Type)	Overloaded: GetMember(string name) See base class member description: System.Type.GetMember Searches for the members with the specified name.
GetMember (inherited from System.Type)	Overloaded: GetMember(string name, BindingFlags bindingAttr) See base class member description: System.Type.GetMember Searches for the specified members, using the specified binding constraints.
GetMember	Overloaded: GetMember(string name, MemberTypes type, BindingFlags bindingAttr) Overridden: Returns all the public and non-public members declared or inherited by this type, as specified.
GetMembers (inherited from System.Type)	Overloaded: GetMembers() See base class member description: System.Type.GetMembers Returns all the public members of the current Type.
GetMembers	Overloaded: GetMembers(BindingFlags bindingAttr) Overridden: Returns the members for the public and non-public members declared or inherited by this type.
GetMethod (inherited from System.Type)	Overloaded: GetMethod(string name) See base class member description: System.Type.GetMethod Searches for the public method with the specified name.
GetMethod (inherited from System.Type)	Overloaded: GetMethod(string name, BindingFlags bindingAttr) See base class member description: System.Type.GetMethod Searches for the specified method, using the specified binding constraints.
GetMethod (inherited from System.Type)	Overloaded: GetMethod(string name, Type[] types) See base class member description: System.Type.GetMethod Searches for the specified public method whose parameters match the specified argument types.
GetMethod (inherited from System.Type)	Overloaded: GetMethod(string name, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetMethod Searches for the specified public method whose parameters match the specified argument types and modifiers.
GetMethod (inherited from System.Type)	Overloaded: GetMethod(string name, BindingFlags bindingAttr, Binder binder, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetMethod Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints.
GetMethod (inherited from System.Type)	Overloaded: GetMethod(string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetMethod Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.
GetMethods (inherited from System.Type)	Overloaded: GetMethods() See base class member description: System.Type.GetMethods Returns all the public methods of the current Type.
GetMethods	Overloaded: GetMethods(BindingFlags bindingAttr) Overridden: Returns all the public and non-public methods declared or inherited by this type, as specified.
GetNestedType (inherited from System.Type)	Overloaded: GetNestedType(string name) See base class member description: System.Type.GetNestedType Searches for the nested type with the specified name.
GetNestedType	Overloaded: GetNestedType(string name, BindingFlags bindingAttr) Overridden: Returns the public and non-public nested types that are declared by this type.
GetNestedTypes (inherited from System.Type)	Overloaded: GetNestedTypes() See base class member description: System.Type.GetNestedTypes Returns all the types nested within the current Type.
GetNestedTypes	Overloaded: GetNestedTypes(BindingFlags bindingAttr) Overridden: Returns the public and non-public nested types that are declared or inherited by this type.
GetProperties (inherited from System.Type)	Overloaded: GetProperties() See base class member description: System.Type.GetProperties Returns all the public properties of the current Type.
GetProperties	Overloaded: GetProperties(BindingFlags bindingAttr) Overridden: Returns all the public and non-public properties declared or inherited by this type, as specified.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name) See base class member description: System.Type.GetProperty Searches for the public property with the specified name.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name, BindingFlags bindingAttr) See base class member description: System.Type.GetProperty Searches for the specified property, using the specified binding constraints.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name, Type returnType) See base class member description: System.Type.GetProperty Searches for the public property with the specified name and return type.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name, Type[] types) See base class member description: System.Type.GetProperty Searches for the specified public property whose parameters match the specified argument types.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name, Type returnType, Type[] types) See base class member description: System.Type.GetProperty Searches for the specified public property whose parameters match the specified argument types.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name, Type returnType, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetProperty Searches for the specified public property whose parameters match the specified argument types and modifiers.
GetProperty (inherited from System.Type)	Overloaded: GetProperty(string name, BindingFlags bindingAttr, Binder binder, Type returnType, Type[] types, ParameterModifier[] modifiers) See base class member description: System.Type.GetProperty Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.
GetType (inherited from System.Object)	See base class member description: System.Object.GetType Derived from System.Object, the primary base class for all objects.
InvokeMember (inherited from System.Type)	Overloaded: InvokeMember(string name, BindingFlags invokeAttr, Binder binder, object target, object[] args) See base class member description: System.Type.InvokeMember Invokes the specified member, using the specified binding constraints and matching the specified argument list.
InvokeMember (inherited from System.Type)	Overloaded: InvokeMember(string name, BindingFlags invokeAttr, Binder binder, object target, object[] args, CultureInfo culture) See base class member description: System.Type.InvokeMember Invokes the specified member, using the specified binding constraints and matching the specified argument list and culture.
InvokeMember	Overloaded: InvokeMember(string name, BindingFlags invokeAttr, Binder binder, object target, object[] args, ParameterModifier[] modifiers, CultureInfo culture, string[] namedParameters) Overridden: Invokes the specified member. The method that is to be invoked must be accessible and provide the most specific match with the specified argument list, under the contraints of the specified binder and invocation attributes.
IsAssignableFrom	Overridden: Determines whether an instance of the current Type can be assigned from an instance of the specified Type.
IsDefined	Overridden: Set a custom attribute using a custom attribute builder.
IsInstanceOfType (inherited from System.Type)	See base class member description: System.Type.IsInstanceOfType Determines whether the specified object is an instance of the current Type.
IsSubclassOf	Overridden: Checks if this type is a derived class of the given type c.
SetCustomAttribute	Overloaded: SetCustomAttribute(CustomAttributeBuilder customBuilder) Set a custom attribute using a custom attribute builder.
SetCustomAttribute	Overloaded: SetCustomAttribute(ConstructorInfo con, byte[] binaryAttribute) Sets a custom attribute using a specified custom attribute blob.
SetParent	Sets the parent of this Type.
ToString	Overridden: Returns the name of the type excluding the namespace.

Protected Methods

Finalize (inherited from System.Object)	See base class member description: System.Object.Finalize Derived from System.Object, the primary base class for all objects.
GetAttributeFlagsImpl	Overridden: Returns the implementation attribute flags.
GetConstructorImpl	Overridden: Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.
GetMethodImpl	Overridden: Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.
GetPropertyImpl	Overridden: Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.
HasElementTypeImpl	Overridden: Calling this method always throws NotSupportedException.
IsArrayImpl	Overridden: Always returns false.
IsByRefImpl	Overridden: Always returns false.
IsCOMObjectImpl	Overridden: Checks if this type imports a COM type.
IsContextfulImpl (inherited from System.Type)	See base class member description: System.Type.IsContextfulImpl Implements the Type.IsContextful property and determines whether the Type can be hosted in a context.
IsMarshalByRefImpl (inherited from System.Type)	See base class member description: System.Type.IsMarshalByRefImpl Implements the Type.IsMarshalByRef property and determines whether the Type is marshalled by reference.
IsPointerImpl	Overridden: Always returns false.
IsPrimitiveImpl	Overridden: Always returns false.
IsValueTypeImpl (inherited from System.Type)	See base class member description: System.Type.IsValueTypeImpl Implements the Type.IsValueType property and determines whether the Type is a value type; that is, not a class or an interface.
MemberwiseClone (inherited from System.Object)	See base class member description: System.Object.MemberwiseClone Derived from System.Object, the primary base class for all objects.

Hierarchy:

• System.Object
• System.Reflection.MemberInfo
• System.Type
• System.Reflection.Emit.TypeBuilder

System.Reflection.Emit.TypeBuilder Member Details

Summary

Represents that total size for the type is not specified.

C# Syntax:

public const int UnspecifiedTypeSize;

Return to top

Summary

Retrieves the dynamic assembly that contains this type definition.

C# Syntax:

public override Assembly Assembly {get;}

Return to top

Summary

Returns the full name of this type qualified by the display name of the assembly.

C# Syntax:

public override string AssemblyQualifiedName {get;}

The format of the returned string is:

<FullTypeName>, <AssemblyDisplayName>

See AssemblyName for a description of the format of the display name of an assembly.

Return to top

Inherited
See base class member description: System.Type.Attributes

Summary

Gets the attributes associated with the Type.

C# Syntax:

public TypeAttributes Attributes {get;}

Return to top

Summary

Retrieves the base type of this type.

C# Syntax:

public override Type BaseType {get;}

Return to top

Summary

Returns the type that declared this type.

C# Syntax:

public override Type DeclaringType {get;}

Return to top

Summary

Retrieves the full path of this type.

C# Syntax:

public override string FullName {get;}

The returned format is "enclosingTypeFullName+nestedTypeName" for nested types and "typeName" for non-nested types.

Return to top

Summary

Retrieves the GUID of this type.

C# Syntax:

public override Guid GUID {get;}

Exceptions

Exception Type	Condition
NotSupportedException	This method is not currently supported for incomplete types.

Retrieve the type using Type.GetType or Assembly.GetType and use reflection on the retrieved type.

Return to top

Inherited
See base class member description: System.Type.HasElementType

Summary

Gets a value indicating whether the current Type encompasses or refers to another type; that is, whether the current Type is an array, a pointer, or is passed by reference.

C# Syntax:

public bool HasElementType {get;}

For example, Type.GetType("Int32[]").HasElementType returns true, but Type.GetType("Int32").HasElementType returns false. HasElementType also returns true for "Int32*" and "Int32&".

public class MyClass 
{
}

public class Type_HasElementType
{
   public static void Main()
   {
      try
      {
         // An non array or pointer or reference element. 
         MyClass myObject1 = new MyClass();
         Object myObject2 = myObject1 ; 

         // An object of array type. 
         MyClass[] myObject3 = new MyClass[5];
         Object myObject4 = myObject3 ; 

         Object[] myObjects = new Object[] { myObject1, myObject2, myObject3, myObject4 };
         
         Console.WriteLine("\nCheck whether the object refers to array or pointer or reference type.\n");                     
         for(int i = 0; i < myObjects.Length; i++)
         {
            if(myObjects[i].GetType().HasElementType)
               Console.WriteLine("'myObject{0}' refers to an array or pointer or reference", i);
            else
               Console.WriteLine("'myObject{0}' does not refer to an array or pointer or reference", i);
         }
      }
      catch( Exception e )
      {
         Console.WriteLine( "Exception: {0} \n", e.Message ) ; 
      }	
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsAbstract

Summary

Gets a value indicating whether the Type is abstract and must be overridden.

C# Syntax:

public bool IsAbstract {get;}

public abstract class MyAbstractClass 
{
}

public class MyClass
{
}

public class Type_IsAbstract
{
   public static void Main()
   {
      try
      {
         Console.WriteLine("\nChecking whether the type is abstract\n"); 

         // Check whether the return Type is abstract or not.
         Console.WriteLine("'MyAbstractClass' is {0}", 
            (typeof(MyAbstractClass).IsAbstract) ? 
            "an abstract class" :
            "not an abstract class" );

         // Check whether the return Type is abstract or not.
         Console.WriteLine("'MyClass' is {0}",
            (typeof(MyClass).IsAbstract) ?
            "an abstract class" : 
            "not an abstract class" );
			
      }
      catch( Exception e )
      {
         Console.WriteLine( "Exception: {0} \n", e.Message ); 
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsAnsiClass

Summary

Gets a value indicating whether the string format attribute AnsiClass is selected for the Type.

C# Syntax:

public bool IsAnsiClass {get;}

The TypeAttributes.StringFormatMask selects the string format attributes. The string format attributes enhance interoperability by defining how strings should be interpreted.

public class MyClass
{
   protected string myField = "A sample protected field" ;
}

public class MyType_IsAnsiClass
{
   public static void Main()
   {
      try
      {
         MyClass myObject = new MyClass();
       
         // Get the type of the 'MyClass'.
         Type myType = typeof(MyClass);

         // Get the field information and the attributes associated with 'MyClass'.
         FieldInfo myFieldInfo = myType.GetField("myField",
            BindingFlags.NonPublic|BindingFlags.Instance);
    
         Console.WriteLine( "\nChecking for AnsiClass attribute for a field\n"); 
         // Get and display the name, field, and the AnsiClass attribute.
         Console.WriteLine("Name of Class: {0} \nValue of Field: {1} \nIsAnsiClass = {2}",
            myType.FullName, myFieldInfo.GetValue(myObject),
            myType.IsAnsiClass);
      }
      catch(Exception e)
      {
         Console.WriteLine("Exception : {0}",e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsArray

Summary

Gets a value indicating whether the Type is an array.

C# Syntax:

public bool IsArray {get;}

The Array class returns false because it is not an array.

This property is read-only.

The following example demonstrates using the IsArray property.

using System;
class TestIsArray 
{
   public static void Main() 
   {
   int [] array = {1,2,3,4};
   Type at = typeof(Array);
   Type t = array.GetType();
   Console.WriteLine("Type is {0}. IsArray? {1}", at, at.IsArray);
   Console.WriteLine("Type is {0}. IsArray? {1}", t, t.IsArray);
   }
}

    

This code produces the following output:

              				Type is System.Array. IsArray? False
              				Type is System.Int32[]. IsArray? True
              			
            

Return to top

Inherited
See base class member description: System.Type.IsAutoClass

Summary

Gets a value indicating whether the string format attribute AutoClass is selected for the Type.

C# Syntax:

public bool IsAutoClass {get;}

The TypeAttributes.StringFormatMask selects the string format attributes. The string format attributes enhance interoperability by defining how strings should be interpreted.

Return to top

Inherited
See base class member description: System.Type.IsAutoLayout

Summary

Gets a value indicating whether the class layout attribute AutoLayout is selected for the Type.

C# Syntax:

public bool IsAutoLayout {get;}

The TypeAttributes.LayoutMask is used to select the class layout attributes. The class layout attributes (AutoLayout,SequentialLayout and ExplicitLayout) define how the fields of the class instance are laid out in memory.

Use the AutoLayout attribute to let the runtime engine decide the best way to layout the objects of the class. Classes marked with the AutoLayout attribute indicate that the loader will choose the appropriate way to lay out the class; any layout information that may have been specified is ignored.

// The MyDemoAttribute class is selected as AutoLayout.
[StructLayoutAttribute(LayoutKind.Auto)]
public class MyDemoAttribute
{
}

public class MyTypeClass
{
   public static void Main(string[] args)
   { 
      MyAutoLayoutMethod("MyDemoAttribute");    
   }

    public static void MyAutoLayoutMethod(string typeName)
   {
      try
      {
         // Create an object of 'Type' class using the 'GetType' method.
         Type  myType=Type.GetType(typeName);
         // Get and display the 'IsAutoLayout' property of the 
         // 'MyDemoAttribute' instance.
         Console.WriteLine("\n The 'Autolayout' property for the 'MyDemoAttribute' is: {0}.",myType.IsAutoLayout); 
      }
      catch(Exception e)
      {
         Console.WriteLine("\nThe following exception is raised: {0}." ,e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsByRef

Summary

Gets a value indicating whether the Type is passed by reference.

C# Syntax:

public bool IsByRef {get;}

Return to top

Inherited
See base class member description: System.Type.IsClass

Summary

Gets a value indicating whether the Type is a class; that is, not a value type or interface.

C# Syntax:

public bool IsClass {get;}

This property returns true for Type instances representing Enum and ValueType.

The TypeAttributes.ClassSemanticsMask distinguishes a type declaration as class, interface, or value type.

This property is read-only.

public  class MyDemoClass
{
   
}

public class MyTypeClass
{
   public static void Main(string[] args)
   {
      try
      {
         Type  myType=Type.GetType("MyDemoClass");
         // Get and display the 'IsClass' property of the 'MyDemoClass' instance.
         Console.WriteLine("\n'MyDemoClass' is of type 'Class': {0}.", myType.IsClass); 
      }
      catch(Exception e)
      {
         Console.WriteLine("\nThe following exception is raised: {0}." ,e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsCOMObject

Summary

Gets a value indicating whether the Type is a COM object.

C# Syntax:

public bool IsCOMObject {get;}

This method returns false for COM interfaces because they are not objects. COM interfaces can be implemented by Microsoft .NET Framework objects.

You can also load a COM class and get a Type object for that COM class by using the tool.

Return to top

Inherited
See base class member description: System.Type.IsContextful

Summary

Gets a value indicating whether the Type can be hosted in a context.

C# Syntax:

public bool IsContextful {get;}

A context intercepts calls to the class members and enforces policies that are applied to the class, such as synchronization. For more detailed information on remoting contexts, see Context.

public class MyContextBoundClass: ContextBoundObject
{
   public string myString = "This class demonstrates the isContextful and isMarshalByRef properties.";
}

public class MyTypeDemoClass
{
   public static void Main()
   {
      try
      {
         // Check if the types can be hosted in a Context.
         Console.WriteLine ("The Contextful property for the '{0}' type is: {1}", typeof(MyTypeDemoClass).Name, typeof(MyTypeDemoClass).IsContextful);
         Console.WriteLine ("The Contextful property for the '{0}' type is: {1}", typeof(MyContextBoundClass).Name, typeof(MyContextBoundClass).IsContextful);

         // Check if the types are marshalled by reference.
         Console.WriteLine ("The MarshalByRef property of '{0}' is: {1} ", typeof(MyTypeDemoClass).Name, typeof(MyTypeDemoClass).IsMarshalByRef);
         Console.WriteLine ("The MarshalByRef property of '{0}' is: {1} ", typeof(MyContextBoundClass).Name, typeof(MyContextBoundClass).IsMarshalByRef);
         // Check if the types are primitive datatypes.
         Console.WriteLine ("'{0}' is a primitive datatype : {1} ", typeof(int).Name, typeof(int).IsPrimitive);
         Console.WriteLine ("'{0}' is a primitive datatype : {1} ", typeof(string).Name, typeof(string).IsPrimitive);
      } 
      catch (Exception e)
      {
         Console.WriteLine("The following exception is raised : " + e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsEnum

Summary

Gets a value indicating whether the current Type represents an enumeration.

C# Syntax:

public bool IsEnum {get;}

This property returns true for an enumeration, but not for the Enum type itself, which is a class.

This property is read-only.

The following example demonstrates using the IsEnum property.

using System;
public enum Color 
{
Red, Blue, Green
}
class TestIsEnum 
{
   public static void Main() 
   {
   Type colorType = typeof(Color);
   Type enumType = typeof(Enum);
   Console.WriteLine("Color is enum? {0}", colorType.IsEnum);
   Console.WriteLine("Color is valueType? {0}", colorType.IsValueType);
   Console.WriteLine("Enum is enum Type? {0}", enumType.IsEnum);
   Console.WriteLine("Enum is value? {0}", enumType.IsValueType);
   }
}

    

This code produces the following output:

              				Color is enum? True
              				Color is valueType? True
              				Enum is enum Type? False
              				Enum is value? False
              			
            

Return to top

Inherited
See base class member description: System.Type.IsExplicitLayout

Summary

Gets a value indicating whether the class layout attribute ExplicitLayout is selected for the Type.

C# Syntax:

public bool IsExplicitLayout {get;}

The TypeAttributes.LayoutMask is used to select the class layout attributes. The class layout attributes (AutoLayout,SequentialLayout and ExplicitLayout) define how the fields of the class instance are laid out in memory.

Classes marked with the ExplicitLayout attribute cause the loader to ignore field sequence and to use the explicit layout rules provided, in the form of field offsets, overall class size and alignment, or all of these.

Use the ExplicitLayout attribute to specify the offsets at which each field starts, or to specify the overall size and, optionally, the packing size of the objects of the class. The packing size is the empty memory space between fields and must be 1, 2, 4, 8 or 16 bytes.

//The class is selected for the ExplicitLayout.
[StructLayoutAttribute(LayoutKind.Explicit)]
public class MyDemoAttribute
{
}

public class MyTypeClass
{
   public static void Main(string[] args)
   {
      MyIsExplicitLayoutMethod("MyDemoAttribute");     
   }
   public static void MyIsExplicitLayoutMethod(string typeName)
   {
     try
      {
         // Create an object of 'Type' class using the 'GetType' method.
         Type  myType=Type.GetType(typeName);
         // Get and display the 'IsExplicitLayout' property.
         Console.WriteLine("\n'MyDemoAttribute' instance's 'IsExplicitLayout' property is: {0}.",myType.IsExplicitLayout); 
      }
      catch(Exception e)
      {
         Console.WriteLine("\nThe following exception is raised: {0}." ,e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsImport

Summary

Gets a value indicating whether the Type was imported from another class.

C# Syntax:

public bool IsImport {get;}

Return to top

Inherited
See base class member description: System.Type.IsInterface

Summary

Gets a value indicating whether the Type is an interface; that is, not a class or a value type.

C# Syntax:

public bool IsInterface {get;}

The TypeAttributes.ClassSemanticsMask distinguishes a type declaration as class, interface or value type.

This property is read-only.

// Interface declaration.
interface myIFace
{

}

class MyIsInterface 
{
   public static void Main(string []args)
   {
      try
      {
         // Get the attribute IsInterface for myIFace.
         bool myBool1 = typeof(myIFace).IsInterface;    
         //Display the IsInterface attribute for myIFace.
         Console.WriteLine("The type mentioned is an interface: {0}",myBool1);
         // Get the attribute IsInterface for MyIsInterface.
         bool myBool2 = typeof(MyIsInterface).IsInterface;    
         //Display the IsInterface attribute for MyIsInterface.
         Console.WriteLine("The type mentioned is an interface: {0}",myBool2);         
      }
      catch(Exception e)
      {
         Console.WriteLine("\nThe following exception is raised : {0}",e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsLayoutSequential

Summary

Gets a value indicating whether the class layout attribute SequentialLayout is selected for the Type.

C# Syntax:

public bool IsLayoutSequential {get;}

The TypeAttributes.LayoutMask is used to select the class layout attributes. The class layout attributes (AutoLayout,SequentialLayout and ExplicitLayout) define how the fields of the class instance are laid out in memory.

Classes marked with the SequentialLayout attribute guides the loader to preserve field order as emitted, but otherwise the specific offsets are calculated based on the common language runtime type of the field; these may be shifted by explicit offset, padding, or alignment information.

Use the SequentialLayout attribute to layout the objects of the class sequentially and to specify the packing size between adjacent fields. The packing size is the empty memory space between fields and must be 1, 2, 4, 8 or 16 bytes. A field will be aligned to its natural size or to the packing size, whichever results in a smaller offset.

// MyTypeSequential1 class declaration.
class MyTypeSequential1
{
}

[StructLayoutAttribute(LayoutKind.Sequential)]
class MyTypeSequential2
{
   public static void Main(string []args)
   {
      try
      {
         // Create an instance of 'myTypeSeq1' class.
         MyTypeSequential1 myObj1 = new MyTypeSequential1();
         Type myTypeObj1 = myObj1.GetType();
         // Check and displays the attribute 'SequentialLayout'.
         Console.WriteLine("\nThe object myObj1 has 'IsLayoutSequential': {0}", myObj1.GetType().IsLayoutSequential);
         // Create an instance of 'myTypeSeq2' class.
         MyTypeSequential2 myObj2 = new MyTypeSequential2();
         Type myTypeObj2 = myObj2.GetType();
         // Check and displays the attribute 'SequentialLayout'.
         Console.WriteLine("\nThe object myObj2 has 'IsLayoutSequential': {0}", myObj2.GetType().IsLayoutSequential);
      }
      catch(Exception e)
      {
         Console.WriteLine("\nThe following exception is raised: {0}",e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsMarshalByRef

Summary

Gets a value indicating whether the Type is marshaled by reference.

C# Syntax:

public bool IsMarshalByRef {get;}

public class MyContextBoundClass: ContextBoundObject
{
   public string myString = "This class demonstrates the isContextful and isMarshalByRef properties.";
}

public class MyTypeDemoClass
{
   public static void Main()
   {
      try
      {
         // Check if the types can be hosted in a Context.
         Console.WriteLine ("The Contextful property for the '{0}' type is: {1}", typeof(MyTypeDemoClass).Name, typeof(MyTypeDemoClass).IsContextful);
         Console.WriteLine ("The Contextful property for the '{0}' type is: {1}", typeof(MyContextBoundClass).Name, typeof(MyContextBoundClass).IsContextful);

         // Check if the types are marshalled by reference.
         Console.WriteLine ("The MarshalByRef property of '{0}' is: {1} ", typeof(MyTypeDemoClass).Name, typeof(MyTypeDemoClass).IsMarshalByRef);
         Console.WriteLine ("The MarshalByRef property of '{0}' is: {1} ", typeof(MyContextBoundClass).Name, typeof(MyContextBoundClass).IsMarshalByRef);
         // Check if the types are primitive datatypes.
         Console.WriteLine ("'{0}' is a primitive datatype : {1} ", typeof(int).Name, typeof(int).IsPrimitive);
         Console.WriteLine ("'{0}' is a primitive datatype : {1} ", typeof(string).Name, typeof(string).IsPrimitive);
      } 
      catch (Exception e)
      {
         Console.WriteLine("The following exception is raised : " + e.Message);
      }
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsNestedAssembly

Summary

Gets a value indicating whether the Type is nested and visible only within its own assembly.

C# Syntax:

public bool IsNestedAssembly {get;}

The TypeAttributes.VisibilityMask selects the visibility attributes.

// Enclose a class.
class MyClassA
{
   // Internal nested class.
   internal class MyClassB
   {
   }
}
class MyTestClass
{
   public static void Main(string[] args)
   {  
      // Get the Type of the nested class.
      Type myTypeB = typeof(MyClassA.MyClassB);
      // Get the 'IsNestedAssembly' property  of the nested class
      // 'Type'.
      Console.WriteLine("\nThe nested class has the property 'IsNestedAssembly' value: "+ 
                         myTypeB.IsNestedAssembly.ToString());
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsNestedFamANDAssem

Summary

Gets a value indicating whether the Type is nested and visible only to classes that belong to both its own family and its own assembly.

C# Syntax:

public bool IsNestedFamANDAssem {get;}

The TypeAttributes.VisibilityMask selects the visibility attributes.

A Type object's family is defined as all objects of the exact same Type and of its subtypes.

Return to top

Inherited
See base class member description: System.Type.IsNestedFamily

Summary

Gets a value indicating whether the Type is nested and visible only within its own family.

C# Syntax:

public bool IsNestedFamily {get;}

The TypeAttributes.VisibilityMask selects the visibility attributes.

A Type object's family is defined as all objects of the exact same Type and of its subtypes.

// Enclose a class.
class MyClassA
{
   // Protected nested class.
   protected class MyClassB
   {
   }   
}
class MyTestClass : MyClassA
{
   public static void Main(string[] args)
   {  
      // Get the Type of the nested class.
      Type myTypeB = typeof(MyClassA.MyClassB);
      // Get the 'IsNestedFamily' property the of the nested class
      // 'Type'.
      Console.WriteLine("\nThe nested class has the property 'IsNestedFamily' value: "+
                        myTypeB.IsNestedFamily.ToString());      
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsNestedFamORAssem

Summary

Gets a value indicating whether the Type is nested and visible only to classes that belong to either its own family or to its own assembly.

C# Syntax:

public bool IsNestedFamORAssem {get;}

The TypeAttributes.VisibilityMask selects the visibility attributes.

A Type object's family is defined as all objects of the exact same Type and of its subtypes.

// Enclose a class.
class MyClassA
{
   // Protected internal nested class.
   protected internal class MyClassB
   {
   }
}
class MyTestClass 
{
   public static void Main(string[] args)
   {        
      // Get the Type of the nested class.
      Type myTypeB = typeof(MyClassA.MyClassB);
      // Get the 'IsNestedFamORAssem' property of the nested class 
      // 'Type'.
      Console.WriteLine("\nThe nested class has the property 'IsNestedFamORAssem' value: "+
                        myTypeB.IsNestedFamORAssem.ToString()); 
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsNestedPrivate

Summary

Gets a value indicating whether the Type is nested and declared private.

C# Syntax:

public bool IsNestedPrivate {get;}

The TypeAttributes.VisibilityMask selects the visibility attributes.

// Outer class.
public class MyClassA
{
   // Private nested class.
   private class MyClassB
   {
   }
   public static void Main(string[] args)
   {	
      // Get the Type of the nested class.
      Type myTypeB = typeof(MyClassA.MyClassB);
      // Get the 'IsNestedPrivate' property of the nested class 'Type'.
      Console.WriteLine("\nThe nested class has the property 'IsNestedPrivate'value: "+
                        myTypeB.IsNestedPrivate.ToString());	
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsNestedPublic

Summary

Gets a value indicating whether a class is nested and declared public.

C# Syntax:

public bool IsNestedPublic {get;}

The TypeAttributes.VisibilityMask selects the visibility attributes.

The following example demonstrates the IsNestedPublic property. A nested class MyClassB is declared as public and the IsNestedPublic property value is displayed.

using System;

// Enclose a class.
public class MyClassA
{
   // Public nested class.
   public class MyClassB
   {
   }
   public static void Main(string[] args)
   {	
      // Get the Type of the nested class.
      Type myTypeB = typeof(MyClassA.MyClassB);
      // Get the 'IsNestedPublic' property of the nested class
      // 'Type'.
      Console.WriteLine("\nThe nested class has the property 'IsNestedPublic' value: "+
                        myTypeB.IsNestedPublic.ToString());			
   }
}

    

Return to top

Inherited
See base class member description: System.Type.IsNotPublic

Summary

Gets a value indicating whether the top-level Type is not declared public.

C# Syntax:

public bool IsNotPublic {get;}

IsPublic and IsNotPublic get the visibility of the top-level type only.

TypeAttributes.VisibilityMask selects the visibility attributes.

This example shows the use of IsNotPublic to get the visibility of the top-level type.

 using System;
 using System.IO;
 using System.Reflection;
 
 class MyMemberInfo { 
 
   public static void Main(string[] args) { 
 
    Console.WriteLine ("\nReflection.MemberInfo");
 
    //Get the Type and MemberInfo 
 
    Type MyType =Type.GetType("System.IO.File");
 
    MemberInfo[] Mymemberinfoarray = MyType.GetMembers();
 
    //Get and display the DeclaringType method
 
    Console.WriteLine("\nThere are {0} members in {1}.",
       Mymemberinfoarray.Length, MyType.FullName);
 
    Console.WriteLine("Is {0} public? {1}", MyType.FullName,
       MyType.IsPublic.ToString());
   }
 }

    

This code produces the following output:

There are 27 members in System.IO.File.

Is System.IO.File public? False

The following code example demonstrates why you cannot use IsPublic and IsNotPublic for nested classes.

public class A {
   public class B { }
   private class C { }
}

    

For nested classes, ignore the results of IsPublic and IsNotPublic and pay attention only to the results of IsNestedPublic and IsNestedPrivate. The reflection output for this code fragment would be as follows:

Class	IsNotPublic	IsPublic	IsNestedPublic	IsNestedPrivate
A	FALSE	TRUE	FALSE	FALSE
B	FALSE	FALSE	TRUE	FALSE
C	FALSE	FALSE	FALSE	TRUE

Return to top

Inherited
See base class member description: System.Type.IsPointer

Summary

Gets a value indicating whether the Type is a pointer.

C# Syntax:

public bool IsPointer {get;}

This property is read-only.

Return to top

Inherited
See base class member description: System.Type.IsPrimitive

Summary

Gets a value indicating whether the Type is one of the primitive types.

C# Syntax:

public bool IsPrimitive {get;}

The primitive types are Boolean, Byte, SByte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Char, Double, and Single.

         // Check if the types are primitive datatypes.
         Console.WriteLine ("'{0}' is a primitive datatype : {1} ", typeof(int).Name, typeof(int).IsPrimitive);
         Console.WriteLine ("'{0}' is a primitive datatype : {1} ", typeof(string).Name, typeof(string).IsPrimitive);

    

Return to top

Inherited
See base class member description: System.Type.IsPublic

Summary

Gets a value indicating whether the top-level Type is declared public.

C# Syntax:

public bool IsPublic {get;}

IsPublic and IsNotPublic get the visibility of the top-level type only.

TypeAttributes.VisibilityMask selects the visibility attributes.

This example shows the use of IsPublic to get the visibility of the top-level type.

 using System;
 using System.IO;
 using System.Reflection;
 
 class MyMemberInfo { 
 
   public static void Main(string[] args) { 
 
    Console.WriteLine ("\nReflection.MemberInfo");
 
    //Get the Type and MemberInfo 
 
    Type MyType =Type.GetType("System.IO.File");
 
    MemberInfo[] Mymemberinfoarray = MyType.GetMembers();
 
    //Get and display the DeclaringType method
 
    Console.WriteLine("\nThere are {0} members in {1}.",
       Mymemberinfoarray.Length, MyType.FullName);
 
    Console.WriteLine("Is {0} public? {1}", MyType.FullName,
       MyType.IsPublic.ToString());
   }
 }

    

This code produces the following output:

There are 27 members in System.IO.File.

Is System.IO.File public? True

The following code example demonstrates why you cannot use IsPublic and IsNotPublic for nested classes.

public class A {
   public class B { }
   private class C { }
}

    

For nested classes, ignore the results of IsPublic and IsNotPublic and pay attention only to the results of IsNestedPublic and IsNestedPrivate. The reflection output for this code fragment would be as follows:

Class	IsNotPublic	IsPublic	IsNestedPublic	IsNestedPrivate
A	FALSE	TRUE	FALSE	FALSE
B	FALSE	FALSE	TRUE	FALSE
C	FALSE	FALSE	FALSE	TRUE

Return to top

Inherited
See base class member description: System.Type.IsSealed

Summary

Gets a value indicating whether the Type is declared sealed.

C# Syntax:

public bool IsSealed {get;}

      // Declare class 'MyTestClass' as sealed.
      sealed public class MyTestClass
      {
      }
      public static void Main(string []args)
      {
         try
         {
            bool myBool = false;
            MyTestClass myTestClassInstance = new MyTestClass();
            // Get Type of 'myTestClassInstance'.
            Type   myType = myTestClassInstance.GetType();
            // Get the 'IsSealed' property of the 'MyTestClass' instance.
            myBool = myType.IsSealed;
            Console.WriteLine("\n{0} class is Sealed: {1}.",myType.FullName,myBool.ToString ());
         }
         catch (Exception e)
         {
            Console.WriteLine("\nThe following exception is raised: {0}",e.Message);
         }
      }

    

Return to top

Inherited
See base class member description: System.Type.IsSerializable

Summary

Gets a value indicating whether the Type is serializable.

C# Syntax:

public bool IsSerializable {get;}

      // Declare a class as public with [Serializable] attribute.
      [Serializable] public class MyTestClass 
      {
      }
      public static void Main(string []args)
      {
         try
         {
            bool myBool = false;
            MyTestClass myTestClassInstance = new MyTestClass();
            // Get Type of 'myTestClassInstance'.
            Type myType = myTestClassInstance.GetType();
            // Get the 'IsSerializable' property of the 'MyTestClass' instance.
            myBool = myType.IsSerializable;
            Console.WriteLine("\n{0} class is Serializable: {1}.",myType.FullName,myBool.ToString ());
         }
         catch (Exception e)
         {
            Console.WriteLine("\nThe following exception is raised: {0}",e.Message);
         }
      }

    

Return to top

Inherited
See base class member description: System.Type.IsSpecialName

Summary

Gets a value indicating whether the Type has a name that requires special handling.

C# Syntax:

public bool IsSpecialName {get;}

Names that begin with or contain an underscore character (_), property accessors, and operator overloading methods are examples of types that might require special treatment by some compilers.

This example shows a use of IsSpecialName to filter internal or private members out of a list.

private void DumpMethods(Type aType)
 {
 if (!ShowMethods)
 return;
 MethodInfo[] mInfo = aType.GetMethods();
 myWriter.WriteLine("Methods"); 
 bool found = false;            
 
   if (mInfo.Length != 0)
   {
    for ( int i=0; i < mInfo.Length; i++ )
    {
    // Only display methods declared in this type. Also 
    // filter out any methods with special names, because these
    // cannot be generally called by the user. That is, their 
    // functionality is usually exposed in other ways, for example,
    // property get/set methods are exposed as properties.
             
     if (mInfo[i].DeclaringType == aType && !mInfo[i].IsSpecialName)
     {        
      found = true;
      StringBuilder modifiers = new StringBuilder();
      if (mInfo[i].IsStatic)   {modifiers.Append("static ");}     
      if (mInfo[i].IsPublic)   {modifiers.Append("public ");}     
      if (mInfo[i].IsFamily)   {modifiers.Append("protected ");}     
      if (mInfo[i].IsAssembly) {modifiers.Append("internal ");}     
      if (mInfo[i].IsPrivate)  {modifiers.Append("private ");}     
    myWriter.WriteLine("{0} {1}", modifiers, mInfo[i]);
      }
    }                      
  }                    
      if (!found)
      {
       myWriter.WriteLine("(none)");
      }
 }

    

Return to top

Inherited
See base class member description: System.Type.IsUnicodeClass

Summary

Gets a value indicating whether the string format attribute UnicodeClass is selected for the Type.

C# Syntax:

public bool IsUnicodeClass {get;}

The TypeAttributes.StringFormatMask is used to select the string format attributes. The string format attributes enhance interoperability by defining how strings should be interpreted.

Return to top

Inherited
See base class member description: System.Type.IsValueType

Summary

Gets a value indicating whether the Type is a value type.

C# Syntax:

public bool IsValueType {get;}

Value types are those that are represented as sequences of bits; value types are not classes or interfaces. These are referred to as "structs" in some programming languages. Enums are a special case of value types.

This property returns true for enumerations, but not for the Enum type itself, which is a class. For an example that demonstrates this behavior, see Type.IsEnum.

This property is read-only.

      // Declare enum type.
      enum MyEnum
      {
         One,
         Two
      }
      public static void Main(string []args)
      {
         try
         {
            bool myBool = false;
            MyEnum myTestEnum = MyEnum.One;
            // Get Type of 'myTestEnum'.
            Type   myType = myTestEnum.GetType();
            // Get the 'IsValueType' property of the 'MyTestEnum' 
            // of variable.
            myBool = myType.IsValueType;
            Console.WriteLine("\n {0} is value type: {1}.",myType.FullName,myBool.ToString());
         }
         catch (Exception e)
         {
            Console.WriteLine("\nThe following exception is raised: {0}",e.Message);
         }
      }

    

Return to top

Inherited
See base class member description: System.Type.MemberType

Summary

Gets a bitmask indicating the member type.

C# Syntax:

public override MemberTypes MemberType {get;}

The following code example shows the MemberType field as a parameter to the GetMember method:

MemberInfo[] others = t.GetMember(mi.Name, mi.MemberType, BindingFlags.Public |
BindingFlags.Static | BindingFlags.NonPublic | BindingFlags.Instance);

    

Return to top

Summary

Retrieves the dynamic module that contains this type definition.

C# Syntax:

public override Module Module {get;}

Return to top

Summary

Retrieves the name of this type.

C# Syntax:

public override string Name {get;}

Return to top

Summary

Retrieves the namespace where this TypeBuilder is defined.

C# Syntax:

public override string Namespace {get;}

Return to top

Summary

Retrieves the packing size of this type.

C# Syntax:

public PackingSize PackingSize {get;}

Return to top

Summary

Returns the type that was used to obtain this type.

C# Syntax:

public override Type ReflectedType {get;}

Return to top

Summary

Retrieves the total size of a type.

C# Syntax:

public int Size {get;}

Return to top

Summary

Not supported in dynamic modules.

C# Syntax:

public override RuntimeTypeHandle TypeHandle {get;}

Exceptions

Exception Type	Condition
NotSupportedException	Not supported in dynamic modules.

Retrieve the type using Type.GetType or Assembly.GetType and use reflection on the retrieved type.

Return to top

Inherited
See base class member description: System.Type.TypeInitializer

Summary

Gets the initializer for the Type.

C# Syntax:

public ConstructorInfo TypeInitializer {get;}

Class initializers are available through Type.GetMember, Type.GetMembers, Type.FindMembers, and Type.GetConstructors.

Return to top

Summary

Returns the type token of this type.

C# Syntax:

public TypeToken TypeToken {get;}

Return to top

Summary

Returns the underlying system type for this TypeBuilder.

C# Syntax:

public override Type UnderlyingSystemType {get;}

Exceptions

Exception Type	Condition
InvalidOperationException	This type is an enum but there is no underlying system type.

Implements:

IReflect.UnderlyingSystemType

Return to top

Summary

Adds declarative security to this type.

C# Syntax:

public void AddDeclarativeSecurity(    SecurityAction action,    PermissionSet pset );

action

The security action to be taken such as Demand, Assert, and so on.

pset

The set of permissions the action applies to.

Exceptions

Exception Type	Condition
ArgumentOutOfRangeException	The action is invalid (RequestMinimum, RequestOptional, and RequestRefuse are invalid).
InvalidOperationException	The containing type has been created using TypeBuilder.CreateType. -or- The permission set pset contains an action that was added earlier by AddDeclarativeSecurity.
ArgumentNullException	pset is null.

AddDeclarativeSecurity may be called several times with each call specifying a security action (such as Demand, Assert, or Deny) and a set of permissions that apply to the action.

Return to top

Summary

Adds an interface that this type implements.

C# Syntax:

public void AddInterfaceImplementation(    Type interfaceType );

interfaceType

The interface that this type implements.

Exceptions

Exception Type	Condition
ArgumentNullException	interfaceType is null.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

Return to top

Summary

Creates a Type object for the class. After defining fields and methods on the class, CreateType is called in order to load its Type object.

C# Syntax:

public Type CreateType();

Return Value:

Returns the new Type object for this class.

Exceptions

Exception Type	Condition
InvalidOperationException	This type has been previously created. -or- The enclosing type has not been created. -or- This type is non-abstract and contains an abstract method. -or- This type is abstract and has a method with a method body. -or- This type is not an abstract class or an interface and has a method without a method body.
NotSupportedException	If the type contains invalid Microsoft Intermediate Language (MSIL) code. -or- The branch target is specified using a 1-byte offset but the target is at a distance greater than 127 bytes from the branch.

If this type is a nested type, the TypeBuilder.CreateType must be called on the nesting (enclosing) type before calling the method on this type.

If the nesting type contains a field that is a value type defined as a nested type (for example, a field that is an enum defined as a nested type), calling TypeBuilder.CreateType on the nesting type will generate a AppDomain.TypeResolve event. This is because the loader cannot determine the size of the nesting type until the nested type has been completed. The caller should define a handler for the AppDomain.TypeResolve event to complete the definition of the nested type by calling TypeBuilder.CreateType on the nested type's TypeBuilder. The following example shows how to define the event handler.

using System;
using System.Reflection;
using System.Reflection.Emit;
using System.Threading;
using System.Text;
using System.Resources;
using System.Collections;
using System.IO;

public class NestedEnum {    
    internal static TypeBuilder enumType = null;
    internal static Type tNested = null;   
    internal static Type tNesting = null;

    public static void Main(String[] args) {
	AssemblyName asmName = new AssemblyName();
	asmName.Name = "NestedEnum";
	AssemblyBuilder asmBuild = Thread.GetDomain().DefineDynamicAssembly(asmName, AssemblyBuilderAccess.RunAndSave);
	ModuleBuilder modBuild = asmBuild.DefineDynamicModule("ModuleOne", "NestedEnum.dll");       

	// Hook up the event listening.
	TypeResolveHandler typeResolveHandler = new TypeResolveHandler(modBuild);
	// Add a listener for the type resolve events.
	AppDomain currentDomain = Thread.GetDomain();
	ResolveEventHandler resolveHandler = new ResolveEventHandler(typeResolveHandler.ResolveEvent);
	currentDomain.TypeResolve += resolveHandler;

	TypeBuilder tb = modBuild.DefineType("aType", TypeAttributes.Public);
	TypeBuilder eb = tb.DefineNestedType("anEnum", TypeAttributes.NestedPublic | TypeAttributes.Sealed, typeof(Enum), null);
	eb.DefineField("value__", typeof(int), FieldAttributes.Private | FieldAttributes.SpecialName);
	FieldBuilder fb = eb.DefineField("foo", eb, FieldAttributes.Public | FieldAttributes.Literal | FieldAttributes.Static);
	fb.SetConstant(1);

	enumType = eb;

	// Comment out this field.
	// When this field is defined, the loader cannot determine the size
	// of the type. Therefore, a TypeResolve event is generated when the
	// nested type is completed.
	tb.DefineField("bar", eb, FieldAttributes.Public);        

	tNesting = tb.CreateType();
	if (tNesting == null)
	    Console.WriteLine("NestingType CreateType failed but didn't throw!");	

	try {
	    tNested = eb.CreateType();
	    if (tNested == null)
		Console.WriteLine("NestedType CreateType failed but didn't throw!");	
	}
	catch {
	    // This is needed because you might have already completed the type in the TypeResolve event.
	}

	if (tNested != null) {
	    Type x = tNested.DeclaringType;
	    if (x == null)
		Console.WriteLine("oops");
	    else 
		Console.WriteLine(x.Name);
	}

	asmBuild.Save( "NestedEnum.dll" );

	// Remove the listener for the type resolve events.
	currentDomain.TypeResolve -= resolveHandler;
    }
}

// Helper class called when a resolve type event is raised.
class TypeResolveHandler 
{
    private Module m_Module;

    public TypeResolveHandler(Module mod)
    {
	m_Module = mod;
    }

    public Assembly ResolveEvent(Object sender, ResolveEventArgs args)
    {
	Console.WriteLine(args.Name);
	// Use args.Name to look up the type name. In this case, you are getting anEnum.
	try {
	    NestedEnum.tNested = NestedEnum.enumType.CreateType();
	}
	catch {
	    // This is needed to throw away InvalidOperationException.
	    // Loader might send the TypeResolve event more than once
	    // and the type might be complete already.
	}

	// Complete the type.		    
	return m_Module.Assembly;
    }
}
    

    

Return to top

Summary

Adds a new constructor to the class, with the given attributes and signature.

C# Syntax:

public ConstructorBuilder DefineConstructor(    MethodAttributes attributes,    CallingConventions callingConvention,    Type[] parameterTypes );

attributes

The attributes of the constructor.

callingConvention

The calling convention of the constructor.

parameterTypes

The types of the parameters of the constructor.

Return Value:

The defined constructor.

Exceptions

Exception Type	Condition
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

Return to top

Summary

Defines the default constructor. The constructor defined here will simply call the default constructor of the parent.

C# Syntax:

public ConstructorBuilder DefineDefaultConstructor(    MethodAttributes attributes );

attributes

A MethodAttributes object representing the attributes to be applied to the constructor.

Return Value:

Returns the constructor.

Exceptions

Exception Type	Condition
NotSupportedException	The parent class does not have a default constructor

Since the default constructor is automatically defined, it is only necessary to call this method if the attributes on the default constructor should be set to something other than MethodBase.Constructor. This method is provided here to make it easier to set the attributes.

Return to top

Summary

Adds a new event to the class, with the given name, attributes and event type.

C# Syntax:

public EventBuilder DefineEvent(    string name,    EventAttributes attributes,    Type eventtype );

name

The name of the event.name cannot contain embedded nulls.

attributes

The attributes of the event.

eventtype

The type of the event.

Return Value:

The defined event.

Exceptions

Exception Type	Condition
ArgumentException	The length of name is zero.
ArgumentNullException	name is null. -or- eventtype is null.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType

Return to top

Summary

Adds a new field to the class, with the given name, attributes and field type.

C# Syntax:

public FieldBuilder DefineField(    string fieldName,    Type type,    FieldAttributes attributes );

fieldName

The name of the field.fieldName cannot contain embedded nulls.

type

The type of the field

attributes

The attributes of the field.

Return Value:

The defined field.

Exceptions

Exception Type	Condition
ArgumentException	The length of fieldName is zero. -or- type is System.Void. -or- A total size was specified for the parent class of this field.
ArgumentNullException	fieldName is null.
InvalidOperationException	The type was previously created using CreateType TypeBuilder.

Return to top

Summary

Defines initialized data field in the .sdata section of the portable executable (PE) file.

C# Syntax:

public FieldBuilder DefineInitializedData(    string name,    byte[] data,    FieldAttributes attributes );

name

The name used to refer to the data.name cannot contain embedded nulls.

data

The blob of data.

attributes

The attributes for the field.

Return Value:

A field to reference the data.

Exceptions

Exception Type	Condition
ArgumentException	Length of name is zero. -or- The size of the data is less than or equal to zero or greater than 0x0fffffff.
ArgumentNullException	name or data is null.
InvalidOperationException	ModuleBuilder.CreateGlobalFunctions has been previously called.

Return to top

Summary

Adds a new method to the class, with the given name and method signature.

C# Syntax:

public MethodBuilder DefineMethod(    string name,    MethodAttributes attributes,    Type returnType,    Type[] parameterTypes );

name

The name of the method.name cannot contain embedded nulls.

attributes

The attributes of the method.

returnType

The return type of the method.

parameterTypes

The types of the parameters of the method.

Return Value:

The defined method.

Exceptions

Exception Type	Condition
ArgumentException	The length of name is zero. -or- The type of the parent of this method is an interface and this method is not virtual.
ArgumentNullException	name is null.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType

Return to top

Summary

Adds a new method to the class, with the given name and method signature.

C# Syntax:

public MethodBuilder DefineMethod(    string name,    MethodAttributes attributes,    CallingConventions callingConvention,    Type returnType,    Type[] parameterTypes );

name

The name of the method.name cannot contain embedded nulls.

attributes

The attributes of the method.

callingConvention

The calling convention of the method.

returnType

The return type of the method.

parameterTypes

The types of the parameters of the method.

Return Value:

The defined method.

Exceptions

Exception Type	Condition
ArgumentException	The length of name is zero. -or- The type of the parent of this method is an interface and this method is not virtual.
ArgumentNullException	name is null.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType

Return to top

Summary

Specifies a given method body that implements a given method declaration.

C# Syntax:

public void DefineMethodOverride(    MethodInfo methodInfoBody,    MethodInfo methodInfoDeclaration );

methodInfoBody

The method body to be used. This should be a MethodBuilder object.

methodInfoDeclaration

The method whose declaration is to be used.

Exceptions

Exception Type	Condition
ArgumentException	methodInfoBody does not belong to this class.
ArgumentNullException	methodInfoBody or methodInfoDeclaration is null.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType. -or- The method methodInfoBody 's declaring type is not this type.

DefineMethodOverride defines a method impl. A method impl is a token point to an implementation and a token pointing to a declaration that the body will implement. The body must be defined on the type the method impl is defined and the body must be virtual. The declaration can be made to a method defined on an interface implemented by the type, a method on a derived class or a method defined in the type. If the declaration is on an interface only, the slot defined for the interface is altered. If the declaration is made to a method on a base type then the slot for the method is overridden and any duplicates for the overridden method are also replaced. The method overridden cannot be the actual method declared. If the method is on the same type then the slot is replaced and any duplicates for the replaced methods are overridden.

Return to top

Summary

Defines a nested type given its name.

C# Syntax:

public TypeBuilder DefineNestedType(    string name );

name

The full path of the type.name cannot contain embedded nulls.

Return Value:

The defined nested type.

Exceptions

Exception Type	Condition
ArgumentException	Length of name is zero.
ArgumentNullException	name is null. -or- A null interface is specified in the interfaces array.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

The nested type needs to be complete before you can reflect on it using Type.GetMembers, Type.GetNestedType, or Type.GetNestedTypes.

See the description of TypeBuilder.CreateType for the order in which nested types and nesting types should be completed.

Return to top

Summary

Defines a nested type given its name and attributes.

C# Syntax:

public TypeBuilder DefineNestedType(    string name,    TypeAttributes attr );

name

The full path of the type.name cannot contain embedded nulls.

attr

The attributes of the type.

Return Value:

The defined nested type.

Exceptions

Exception Type	Condition
ArgumentException	The nested attribute is not specified. -or- This type is sealed. -or- This type is an array. -or- This type is an interface but the nested type is not an interface. -or- The length of name is zero.
ArgumentNullException	name is null. - or- A null interface is specified in the interfaces array.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

The nested type needs to be complete before you can reflect on it using Type.GetMembers, Type.GetNestedType, or Type.GetNestedTypes.

See the description of TypeBuilder.CreateType for the order in which nested types and nesting types should be completed.

Return to top

Summary

Defines a nested type given its name, attributes, and the type that it extends.

C# Syntax:

public TypeBuilder DefineNestedType(    string name,    TypeAttributes attr,    Type parent );

name

The full path of the type.name cannot contain embedded nulls.

attr

The attributes of the type.

parent

The type that the nested type extends.

Return Value:

The defined nested type.

Exceptions

Exception Type	Condition
ArgumentException	The nested attribute is not specified. -or- This type is sealed. -or- This type is an array. -or- This type is an interface but the nested type is not an interface. -or- The length of name is zero.
ArgumentNullException	name is null. - or- A null interface is specified in the interfaces array.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

The nested type needs to be complete before you can reflect on it using Type.GetMembers, Type.GetNestedType, or Type.GetNestedTypes.

See the description of TypeBuilder.CreateType for the order in which nested types and nesting types should be completed.

Return to top

Summary

Defines a nested type given its name, attributes, the total size of the type, and the type that it extends.

C# Syntax:

public TypeBuilder DefineNestedType(    string name,    TypeAttributes attr,    Type parent,    int typeSize );

name

The full path of the type.name cannot contain embedded nulls.

attr

The attributes of the type.

parent

The type that the nested type extends.

typeSize

The total size of the type.

Return Value:

The defined nested type.

Exceptions

Exception Type	Condition
ArgumentException	The nested attribute is not specified. -or- This type is sealed. -or- This type is an array. -or- This type is an interface but the nested type is not an interface. -or- The length of name is zero.
ArgumentNullException	name is null. - or- A null interface is specified in the interfaces array.
InvalidOperationException	if the type was previously created using TypeBuilder.CreateType.

The nested type needs to be complete before you can reflect on it using Type.GetMembers, Type.GetNestedType, or Type.GetNestedTypes.

See the description of TypeBuilder.CreateType for the order in which nested types and nesting types should be completed.

Return to top

Summary

Defines a nested type given its name, attributes, the total size of the type, and the type that it extends.

C# Syntax:

public TypeBuilder DefineNestedType(    string name,    TypeAttributes attr,    Type parent,    PackingSize packSize );

name

The full path of the type.name cannot contain embedded nulls.

attr

The attributes of the type.

parent

The type that the nested type extends.

packSize

The packing size of the type.

Return Value:

The defined nested type.

Exceptions

Exception Type	Condition
ArgumentException	The nested attribute is not specified. -or- This type is sealed. -or- This type is an array. -or- This type is an interface but the nested type is not an interface. -or- The length of name is zero.
ArgumentNullException	name is null. - or- A null interface is specified in the interfaces array.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

The nested type needs to be complete before you can reflect on it using Type.GetMembers, Type.GetNestedType, or Type.GetNestedTypes.

See the description of TypeBuilder.CreateType for the order in which nested types and nesting types should be completed.

Return to top

Summary

Defines a nested type given its name, attributes, the type that it extends, and the interfaces that it implements.

C# Syntax:

public TypeBuilder DefineNestedType(    string name,    TypeAttributes attr,    Type parent,    Type[] interfaces );

name

The full path of the type.name cannot contain embedded nulls.

attr

The attributes of the type.

parent

The type that the nested type extends.

interfaces

The interfaces that the nested type implements.

Return Value:

The defined nested type.

Exceptions

Exception Type	Condition
ArgumentException	The nested attribute is not specified. -or- This type is sealed. -or- This type is an array. -or- This type is an interface but the nested type is not an interface. -or- The length of name is zero.
ArgumentNullException	name is null or a null interface is specified in the interfaces array.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

The nested type needs to be complete before you can reflect on it using Type.GetMembers, Type.GetNestedType, or Type.GetNestedTypes.

See the description of TypeBuilder.CreateType for the order in which nested types and nesting types should be completed.

Return to top

Summary

Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.

C# Syntax:

public MethodBuilder DefinePInvokeMethod(    string name,    string dllName,    MethodAttributes attributes,    CallingConventions callingConvention,    Type returnType,    Type[] parameterTypes,    CallingConvention nativeCallConv,    CharSet nativeCharSet );

name

The name of the PInvoke method.name cannot contain embedded nulls.

dllName

The name of the DLL in which the PInvoke method is defined.

attributes

The attributes of the method.

callingConvention

The method's calling convention.

returnType

The method's return type.

parameterTypes

The types of the method's parameters.

nativeCallConv

The native calling convention.

nativeCharSet

The method's native character set.

Return Value:

The defined PInvoke method.

Exceptions

Exception Type	Condition
ArgumentException	The method is not static. -or- The parent type is an interface. -or- The method is abstract. -or- The method was previously defined. -or- The length of name or dllName is zero.
ArgumentNullException	name or dllName is null.
InvalidOperationException	The containing type has been previously created using TypeBuilder.CreateType.

Some DLL import attributes (see the description of System.Runtime.InteropServices.DllImportAttribute) cannot be specified as arguments to this method. Such attributes should be set by emitting a custom attribute for the method. For example, the DLL import attribute PreserveSig is set by emitting a custom attribute.

Return to top

Summary

Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.

C# Syntax:

public MethodBuilder DefinePInvokeMethod(    string name,    string dllName,    string entryName,    MethodAttributes attributes,    CallingConventions callingConvention,    Type returnType,    Type[] parameterTypes,    CallingConvention nativeCallConv,    CharSet nativeCharSet );

name

The name of the PInvoke method.name cannot contain embedded nulls.

dllName

The name of the DLL in which the PInvoke method is defined.

entryName

The name of the entry point in the DLL.

attributes

The attributes of the method.

callingConvention

The method's calling convention.

returnType

The method's return type.

parameterTypes

The types of the method's parameters.

nativeCallConv

The native calling convention.

nativeCharSet

The method's native character set.

Return Value:

The defined PInvoke method.

Exceptions

Exception Type	Condition
ArgumentException	The method is not static. -or- The parent type is an interface. -or- The method is abstract. -or- The method was previously defined. -or- The length of name,dllName, or entryName is zero.
ArgumentNullException	name, dllName, or entryName is null.
InvalidOperationException	The containing type has been previously created using TypeBuilder.CreateType.

Some DLL import attributes (see the description of System.Runtime.InteropServices.DllImportAttribute) cannot be specified as arguments to this method. Such attributes should be set by emitting a custom attribute for the method. For example, the DLL import attribute PreserveSig is set by emitting a custom attribute.

Return to top

Summary

Adds a new property to the class, with the given name and property signature.

C# Syntax:

public PropertyBuilder DefineProperty(    string name,    PropertyAttributes attributes,    Type returnType,    Type[] parameterTypes );

name

The name of the property.name cannot contain embedded nulls.

attributes

The attributes of the property.

returnType

The return type of the property.

parameterTypes

The types of the parameters of the property.

Return Value:

The defined property.

Exceptions

Exception Type	Condition
ArgumentException	The length of name is zero.
ArgumentNullException	name is null -or- if any of the elements of the parameterTypes array is null
InvalidOperationException	The type was previously created using TypeBuilder.CreateType

Return to top

Summary

Defines the initializer for this type.

C# Syntax:

public ConstructorBuilder DefineTypeInitializer();

Return Value:

Returns a type initializer.

Exceptions

Exception Type	Condition
InvalidOperationException	The containing type has been previously created using TypeBuilder.CreateType.

The initializer created is always public.

Return to top

Summary

Defines uninitialized data field in the .sdata section of the portable executable (PE) file.

C# Syntax:

public FieldBuilder DefineUninitializedData(    string name,    int size,    FieldAttributes attributes );

name

The name used to refer to the data.name cannot contain embedded nulls.

size

The blob of data.

attributes

The attributes for the field.

Return Value:

A field to reference the data.

Exceptions

Exception Type	Condition
ArgumentException	Length of name is zero. -or- The size of the data is less than or equal to zero or greater than 0x003f0000.
ArgumentNullException	name is null.
InvalidOperationException	The type was previously created using TypeBuilder.CreateType.

Return to top

Inherited
See base class member description: System.Type.Equals

Summary

Determines if the underlying system type of the current Type is the same as the underlying system type of the specified Object.

C# Syntax:

public override bool Equals(    object o );

o

The Object whose underlying system type is to be compared with the underlying system type of the current Type.

Return Value:

true if the underlying system type of o is the same as the underlying system type of the current Type; otherwise, false. This method also returns false if the object specified by the o parameter is not a Type.

This method overrides Object.Equals.

The following example uses Equals to compare two Object instances.

using System;
 using System.Reflection;
 
 class EqType
 {
   public static void Main(String[] args)
   {
    Type a = typeof(EqType);
    Type b = typeof(Type);
    Console.WriteLine("{0}", a.Equals(b).ToString());
    b = (new EqType()).GetType();
    Console.WriteLine("{0}", a.Equals(b).ToString());
   }
 }
 
 //This code produces the following output:
 //False
 //True

    

Return to top

Inherited
See base class member description: System.Type.Equals

Summary

Determines if the underlying system type of the current Type is the same as the underlying system type of the specified Type.

C# Syntax:

public bool Equals(    Type o );

o

The Type whose underlying system type is to be compared with the underlying system type of the current Type.

Return Value:

true if the underlying system type of o is the same as the underlying system type of the current Type; otherwise, false.

The following example uses Equals to compare two types.

 using System;
 using System.Reflection;
 
 class EqType
 {
   public static void Main(String[] args)
   {
    int a = 1;
    float b = 1;
    Console.WriteLine("{0}", a.Equals(b).ToString());
    b=a;
    Console.WriteLine("{0}", a.Equals(b).ToString());
   }
 }
 
 //This code produces the following output:
 //False
 //False

    

Return to top

Inherited
See base class member description: System.Object.Finalize

C# Syntax:

~TypeBuilder();

For more information on members inherited from System.Object click on the link above.

Return to top

Inherited
See base class member description: System.Type.FindInterfaces

Summary

Returns an array of Type objects representing a filtered list of interfaces implemented or inherited by the current Type.

C# Syntax:

public virtual Type[] FindInterfaces(    TypeFilter filter,    object filterCriteria );

filter

The TypeFilter delegate that compares the interfaces against filterCriteria. The TypeFilter delegate that compares the interfaces against filterCriteria.

filterCriteria

The search criteria that determines whether an interface should be included in the returned array.

Return Value:

An array of Type objects representing a filtered list of the interfaces implemented or inherited by the current Type.

-or-

An empty array of type Type, if no interfaces matching the filter are implemented or inherited by the current Type.

Exceptions

Exception Type	Condition
ArgumentNullException	filter is null.
TargetInvocationException	A static initializer is invoked and throws an exception.

This method can be overridden by a derived class.

The Module.FilterTypeName and Module.FilterTypeNameIgnoreCase delegates supplied by the Module class may also be used, in lieu of the TypeFilter delegate.

All of the interfaces implemented by this class are considered during the search, whether declared by a base class or this class itself.

This method searches the base class hierarchy, returning each of the matching interfaces each class implements as well as all the matching interfaces each of those interfaces implements (that is, the transitive closure of the matching interfaces is returned). No duplicate interfaces are returned.

using System;
using System.Xml;
using System.Reflection;

public class MyFindInterfacesSample 
{
   public static void Main()
   {
      try
      {
         XmlDocument myXMLDoc = new XmlDocument();
         myXMLDoc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
            "<title>Pride And Prejudice</title>" + "</book>");
         Type myType = myXMLDoc.GetType();

         // Specify the TypeFilter delegate that compares the interfaces against filter criteria.
         TypeFilter myFilter = new TypeFilter(MyInterfaceFilter);
         String[] myInterfaceList = new String[2] {"System.Collections.IEnumerable",
             "System.Collections.ICollection"};

         for(int index=0; index < myInterfaceList.Length; index++)
         {
            Type[] myInterfaces = myType.FindInterfaces(myFilter, myInterfaceList[index]);
				
            if (myInterfaces.Length > 0) 
            {
               Console.WriteLine("\nThe {0} implements the interface {1}", myType, myInterfaceList[index]);	
               for(int j =0;j < myInterfaces.Length;j++)
                  Console.WriteLine("Interfaces supported #{0} : {1}",j,myInterfaces[j].ToString());
            }
            else
               Console.WriteLine("\nThe {0} does not implement the interface {1}",myType,myInterfaceList[index]);	
         }
      }
      catch(ArgumentNullException e)
      {
         Console.WriteLine("ArgumentNullException : " + e.Message);
      }
      catch(TargetInvocationException e)
      {
         Console.WriteLine("TargetInvocationException : " + e.Message);
      }
      catch(Exception e)
      {
         Console.WriteLine("Exception : " + e.Message);
      }
   }
      
	public static bool MyInterfaceFilter(Type typeObj,Object criteriaObj)
	{
		if(typeObj.ToString() == criteriaObj.ToString())
		   return true;
		else
		   return false;
	}
}

    

Return to top

Inherited
See base class member description: System.Type.FindMembers

Summary

Returns a filtered array of MemberInfo objects of the specified member type.

C# Syntax:

public virtual MemberInfo[] FindMembers(    MemberTypes memberType,    BindingFlags bindingAttr,    MemberFilter filter,    object filterCriteria );

memberType

A MemberTypes object indicating the type of member to search for.

bindingAttr

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

filter

The delegate that does the comparisons, returning true if the member currently being inspected matches the filterCriteria and false otherwise. You can use the FilterAttribute, FilterName, and FilterNameIgnoreCase delegates supplied by this class. The first uses the fields of FieldAttributes, MethodAttributes, and MethodImplAttributes as search criteria, and the other two delegates use String objects as the search criteria.

filterCriteria

The search criteria that determines whether a member is returned in the array of MemberInfo objects.

The fields of FieldAttributes, MethodAttributes, and MethodImplAttributes can be used in conjunction with the FilterAttribute delegate supplied by this class.

The search criteria that determines whether a member is returned in the array of MemberInfo objects.

The fields of FieldAttributes, MethodAttributes, and MethodImplAttributes can be used in conjunction with the FilterAttribute delegate supplied by this class.

Return Value:

A filtered array of MemberInfo objects of the specified member type.

-or-

An empty array of type MemberInfo, if the current Type does not have members of type memberType that match the filter criteria.

Exceptions

Exception Type	Condition
ArgumentNullException	filter is null.

This method can be overridden by a derived class.

Members include properties, methods, fields, events, and so on. If the requested type is non-public and the caller does not have ReflectionPermission to reflect non-public objects outside the current assembly, this method returns null.

The following BindingFlags filter flags can be used to define which members to include in the search:

• Instance to include instance members in the search.
• Static to include static members in the search.
• Public to include public members in the search.
• NonPublic to include non-public members (that is, private and protected members) in the search.

The following BindingFlags modifier flags can be used to change how the search works:

• DeclaredOnly to search only the members declared on the Type, not members that were simply inherited.

See BindingFlags for more information.

Valid values for MemberType are defined in MemberInfo. If no such members are found, an empty array is returned.

Class initializers are available through Type.GetMember, Type.GetMembers, Type.FindMembers, and Type.GetConstructors.

ReflectionPermission for reflecting non-public objects. Associated enumeration: ReflectionPermissionFlag.TypeInformation

Return to top

Inherited
See base class member description: System.Type.GetArrayRank

Summary

Gets the number of dimensions in an Array.

C# Syntax:

public virtual int GetArrayRank();

Return Value:

An Int32 containing the number of dimensions in the current Type.

Exceptions

Exception Type	Condition
NotSupportedException	The functionality of this method is unsupported in the base class and must be implemented in a derived class instead.
ArgumentException	The current Type is not an array.

using System;

class MyArrayRankSample
{
   public static void Main()
   {
      try
      {
         int[,,] myArray = new int[,,] {{{12,2,35},{300,78,33}},{{92,42,135},{30,7,3}}};
         Type myType = myArray.GetType();

         Console.WriteLine("Contents of myArray: {{{12,2,35},{300,78,33}},{{92,42,135},{30,7,3}}}");
         Console.WriteLine("The rank for myArray is: {0}", myType.GetArrayRank());
      }
      catch(NotSupportedException e)
      {
         Console.WriteLine("NotSupportedException raised.");
         Console.WriteLine("Source: " + e.Source);
         Console.WriteLine("Message: " + e.Message);
      }
      catch(Exception e)
      {
         Console.WriteLine("Exception raised.");
         Console.WriteLine("Source: " + e.Source);
         Console.WriteLine("Message: " + e.Message);
      }      
   }
}

    

Return to top

Summary

Returns the implementation attribute flags.

C# Syntax:

protected override TypeAttributes GetAttributeFlagsImpl();

Return Value:

Returns the implementation attribute flags.

Return to top

Inherited
See base class member description: System.Type.GetConstructor

Summary

Searches for a public instance constructor whose parameters match the types in the specified array.

C# Syntax:

public ConstructorInfo GetConstructor(    Type[] types );

types

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type to get a constructor that takes no parameters.

-or-

Type.EmptyTypes.

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type to get a constructor that takes no parameters.

-or-

Type.EmptyTypes.

Return Value:

A ConstructorInfo object representing the public instance constructor whose parameters match the types in the parameter type array, if found; otherwise, null.

Exceptions

Exception Type	Condition
ArgumentNullException	types is null. -or- One of the elements in types is null.
ArgumentException	types is multidimensional.

Type.GetConstructor looks for public instance constructors and cannot be used to obtain a class initializer. Class initializers are available through Type.GetMember, Type.GetMembers, Type.FindMembers, Type.GetConstructors, and Type.TypeInitializer.

If the requested type is non-public and the caller does not have ReflectionPermission to reflect non-public objects outside the current assembly, this method returns null.

Note You cannot omit parameters when looking up constructors and methods. You can only omit parameters when invoking.

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

public class MyClass1
{
   public 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 constructor that takes an integer as a parameter.
         ConstructorInfo constructorInfoObj = myType.GetConstructor(types);
         if (constructorInfoObj != null)
         {
            Console.WriteLine("The constructor of the class MyClass1 that takes an " + 
               "integer as a parameter is: "); 
            Console.WriteLine(constructorInfoObj.ToString());
         }
         else
         {
            Console.WriteLine("The constructor of the class MyClass1 that takes an integer " +
               "as a parameter is not available."); 
         }
      }
      catch(Exception e)
      {
         Console.WriteLine("Exception caught.");
         Console.WriteLine("Source: " + e.Source);
         Console.WriteLine("Message: " + e.Message);
      }
   }
}

    

ReflectionPermission for reflecting non-public objects. Associated enumeration: ReflectionPermissionFlag.TypeInformation

Return to top

Inherited
See base class member description: System.Type.GetConstructor

Summary

Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints.

C# Syntax:

public ConstructorInfo GetConstructor(    BindingFlags bindingAttr,    Binder binder,    Type[] types,    ParameterModifier[] modifiers );

bindingAttr

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

binder

A Binder object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-or-

null, to use the Type.DefaultBinder.

A Binder object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-or-

null, to use the Type.DefaultBinder.

types

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.

-or-

Type.EmptyTypes.

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.

-or-

Type.EmptyTypes.

modifiers

An array of ParameterModifier objects representing the attributes associated with the corresponding element in the parameter type array. The default binder does not process this parameter.

Return Value:

A ConstructorInfo object representing the constructor that matches the specified requirements, if found; otherwise, null.

Exceptions

Exception Type	Condition
ArgumentNullException	types is null. -or- One of the elements in types is null.
ArgumentException	types is multidimensional. -or- modifiers is multidimensional. -or- types and modifiers do not have the same length.

The types array and the modifiers array have the same length. A parameter specified in the types array can have the following attributes, which are specified in the modifiers array: pdIn, pdOut, pdLcid, pdRetval, pdOptional, and pdHasDefault, which represent [In], [Out], [lcid], [retval], [optional], and a value specifying whether the parameter has a default value. A parameter's associated attributes are stored in the metadata and enhance interoperability.

If an exact match does not exist, the binder will attempt to coerce the parameter types specified in the types array in order to select a match. If the binder is unable to select a match, then null is returned.

If the requested type is non-public and the caller does not have ReflectionPermission to reflect non-public objects outside the current assembly, this method returns null.

The following BindingFlags filter flags can be used to define which constructors to include in the search:

• You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.
• Specify BindingFlags.Public to include public constructors in the search.
• Specify BindingFlags.NonPublic to include non-public constructors (that is, private and protected constructors) in the search.
• Specify BindingFlags.FlattenHierarchy to include static members up the hierarchy.

See BindingFlags for more information.

Type.GetConstructor cannot be used to obtain a class initializer. Class initializers are available through Type.GetMember, Type.GetMembers, Type.FindMembers, Type.GetConstructors, and Type.TypeInitializer.

Note You cannot omit parameters when looking up constructors and methods. You can only omit parameters when invoking.

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 constructor that is public and takes an integer parameter.
         ConstructorInfo constructorInfoObj = myType.GetConstructor(
            BindingFlags.Instance | BindingFlags.Public, null, types, null);
         if (constructorInfoObj != null )
         {
            Console.WriteLine("The constructor of the MyClass1 class that is public " +
               "and takes an integer as a parameter is:");
            Console.WriteLine(constructorInfoObj.ToString());
         }
         else
         {
            Console.WriteLine("The constructor of the MyClass1 class that is public " +
               "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);
      }
   }
}

    

ReflectionPermission for reflecting non-public objects. Associated enumeration: ReflectionPermissionFlag.TypeInformation

Return to top

Inherited
See base class member description: System.Type.GetConstructor

Summary

Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.

C# Syntax:

public ConstructorInfo GetConstructor(    BindingFlags bindingAttr,    Binder binder,    CallingConventions callConvention,    Type[] types,    ParameterModifier[] modifiers );

bindingAttr

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

binder

A Binder object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-or-

null, to use the Type.DefaultBinder.

A Binder object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-or-

null, to use the Type.DefaultBinder.

callConvention

The CallingConventions object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and the stack is cleaned up.

types

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.

modifiers

An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. The default binder does not process this parameter.

Return Value:

A ConstructorInfo object representing the constructor that matches the specified requirements, if found; otherwise, null.

Exceptions

Exception Type	Condition
ArgumentNullException	types is null. -or- One of the elements in types is null.
ArgumentException	types is multidimensional. -or- modifiers is multidimensional. -or- types and modifiers do not have the same length.

Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract Binder class to write a custom binder that does process modifiers.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

The types array and the modifiers array have the same length. A parameter specified in the types array can have the following attributes, which are specified in the modifiers array: pdIn, pdOut, pdLcid, pdRetval, pdOptional, and pdHasDefault, which represent [In], [Out], [lcid], [retval], [optional], and a value specifying whether the parameter has a default value. A parameter's associated attributes are stored in the metadata and enhance interoperability.

If an exact match does not exist, the binder will attempt to coerce the parameter types specified in the types array in order to select a match. If the binder is unable to select a match, then null is returned.

The following BindingFlags filter flags can be used to define which constructors to include in the search:

• You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.
• Specify BindingFlags.Public to include public constructors in the search.
• Specify BindingFlags.NonPublic to include non-public constructors (that is, private and protected constructors) in the search.
• Specify BindingFlags.FlattenHierarchy to include static members up the hierarchy.

See BindingFlags for more information.

Type.GetConstructor cannot be used to obtain a class initializer. Class initializers are available through Type.GetMember, Type.GetMembers, Type.FindMembers, Type.GetConstructors, and Type.TypeInitializer.

If the requested type is non-public and the caller does not have ReflectionPermission to reflect non-public objects outside the current assembly, this method returns null.

The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Member Type	Static	Non-Static
Constructor	No	No
Field	No	Yes. A field is always hide-by-name-and-signature.
Event	Not applicable	The common type system rule is that the inheritance is the same as that of the methods that implement the property. Reflection treats properties as hide-by-name-and-signature. See note 2 below.
Method	No	Yes. A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
Nested Type	No	No
Property	Not applicable	The common type system rule is that the inheritance is the same as that of the methods that implement the property. Reflection treats properties as hide-by-name-and-signature. See note 2 below.

1. Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. This is a binary comparison.
2. For reflection, properties and events are hide-by-name-and-signature. If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.
3. Custom attributes are not part of the common type system.

Note You cannot omit parameters when looking up constructors and methods. You can only omit parameters when invoking.

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 constructor that is public, instance method and 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 the class 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 the class '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);
      }
   }
}

    

ReflectionPermission for reflecting non-public objects. Associated enumeration: ReflectionPermissionFlag.TypeInformation

Return to top

Summary

Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.

C# Syntax:

protected override ConstructorInfo GetConstructorImpl(    BindingFlags bindingAttr,    Binder binder,    CallingConventions callConvention,    Type[] types,    ParameterModifier[] modifiers );

bindingAttr

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to conduct a case-sensitive search for public methods.

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to conduct a case-sensitive search for public methods.

binder

A Binder object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-or-

null, to use the Type.DefaultBinder.

A Binder object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-or-

null, to use the Type.DefaultBinder.

callConvention

The CallingConventions object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and the stack is cleaned up.

types

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.

An array of Type objects representing the number, order, and type of the parameters for the constructor to get.

-or-

An empty array of the type Type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters.

modifiers

An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array.