Export (0) Print
Expand All

TypeBuilder Class

Defines and creates new instances of classes during run time.

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

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

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public sealed class TypeBuilder : Type, 
	_TypeBuilder

The TypeBuilder type exposes the following members.

  NameDescription
Public propertyAssemblyRetrieves the dynamic assembly that contains this type definition. (Overrides Type.Assembly.)
Public propertyAssemblyQualifiedNameReturns the full name of this type qualified by the display name of the assembly. (Overrides Type.AssemblyQualifiedName.)
Public propertyAttributesGets the attributes associated with the Type. (Inherited from Type.)
Public propertyBaseTypeRetrieves the base type of this type. (Overrides Type.BaseType.)
Public propertyContainsGenericParametersGets a value indicating whether the current Type object has type parameters that have not been replaced by specific types. (Inherited from Type.)
Public propertyDeclaringMethodGets the method that declared the current generic type parameter. (Overrides Type.DeclaringMethod.)
Public propertyDeclaringTypeReturns the type that declared this type. (Overrides Type.DeclaringType.)
Public propertyFullNameRetrieves the full path of this type. (Overrides Type.FullName.)
Public propertyGenericParameterAttributesGets a value that indicates the covariance and special constraints of the current generic type parameter. (Overrides Type.GenericParameterAttributes.)
Public propertyGenericParameterPositionGets the position of a type parameter in the type parameter list of the generic type that declared the parameter. (Overrides Type.GenericParameterPosition.)
Public propertyGUIDRetrieves the GUID of this type. (Overrides Type.GUID.)
Public propertyHasElementTypeGets 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. (Inherited from Type.)
Public propertyIsAbstractGets a value indicating whether the Type is abstract and must be overridden. (Inherited from Type.)
Public propertyIsAnsiClassGets a value indicating whether the string format attribute AnsiClass is selected for the Type. (Inherited from Type.)
Public propertyIsArrayGets a value indicating whether the Type is an array. (Inherited from Type.)
Public propertyIsAutoClassGets a value indicating whether the string format attribute AutoClass is selected for the Type. (Inherited from Type.)
Public propertyIsAutoLayoutGets a value indicating whether the class layout attribute AutoLayout is selected for the Type. (Inherited from Type.)
Public propertyIsByRefGets a value indicating whether the Type is passed by reference. (Inherited from Type.)
Public propertyIsClassGets a value indicating whether the Type is a class; that is, not a value type or interface. (Inherited from Type.)
Public propertyIsCOMObjectGets a value indicating whether the Type is a COM object. (Inherited from Type.)
Public propertyIsContextfulGets a value indicating whether the Type can be hosted in a context. (Inherited from Type.)
Public propertyIsEnumGets a value indicating whether the current Type represents an enumeration. (Inherited from Type.)
Public propertyIsExplicitLayoutGets a value indicating whether the class layout attribute ExplicitLayout is selected for the Type. (Inherited from Type.)
Public propertyIsGenericParameterGets a value indicating whether the current type is a generic type parameter. (Overrides Type.IsGenericParameter.)
Public propertyIsGenericTypeGets a value indicating whether the current type is a generic type. (Overrides Type.IsGenericType.)
Public propertyIsGenericTypeDefinitionGets a value indicating whether the current TypeBuilder represents a generic type definition from which other generic types can be constructed. (Overrides Type.IsGenericTypeDefinition.)
Public propertyIsImportGets a value indicating whether the Type has a ComImportAttribute attribute applied, indicating that it was imported from a COM type library. (Inherited from Type.)
Public propertyIsInterfaceGets a value indicating whether the Type is an interface; that is, not a class or a value type. (Inherited from Type.)
Public propertyIsLayoutSequentialGets a value indicating whether the class layout attribute SequentialLayout is selected for the Type. (Inherited from Type.)
Public propertyIsMarshalByRefGets a value indicating whether the Type is marshaled by reference. (Inherited from Type.)
Public propertyIsNestedGets a value indicating whether the current Type object represents a type whose definition is nested inside the definition of another type. (Inherited from Type.)
Public propertyIsNestedAssemblyGets a value indicating whether the Type is nested and visible only within its own assembly. (Inherited from Type.)
Public propertyIsNestedFamANDAssemGets a value indicating whether the Type is nested and visible only to classes that belong to both its own family and its own assembly. (Inherited from Type.)
Public propertyIsNestedFamilyGets a value indicating whether the Type is nested and visible only within its own family. (Inherited from Type.)
Public propertyIsNestedFamORAssemGets 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. (Inherited from Type.)
Public propertyIsNestedPrivateGets a value indicating whether the Type is nested and declared private. (Inherited from Type.)
Public propertyIsNestedPublicGets a value indicating whether a class is nested and declared public. (Inherited from Type.)
Public propertyIsNotPublicGets a value indicating whether the Type is not declared public. (Inherited from Type.)
Public propertyIsPointerGets a value indicating whether the Type is a pointer. (Inherited from Type.)
Public propertyIsPrimitiveGets a value indicating whether the Type is one of the primitive types. (Inherited from Type.)
Public propertyIsPublicGets a value indicating whether the Type is declared public. (Inherited from Type.)
Public propertyIsSealedGets a value indicating whether the Type is declared sealed. (Inherited from Type.)
Public propertyIsSecurityCriticalGets a value that indicates whether the current type is security-critical or security-safe-critical, and therefore can perform critical operations. (Overrides Type.IsSecurityCritical.)
Public propertyIsSecuritySafeCriticalGets a value that indicates whether the current type is security-safe-critical; that is, whether it can perform critical operations and can be accessed by transparent code. (Overrides Type.IsSecuritySafeCritical.)
Public propertyIsSecurityTransparentGets a value that indicates whether the current type is transparent, and therefore cannot perform critical operations. (Overrides Type.IsSecurityTransparent.)
Public propertyIsSerializableGets a value indicating whether the Type is serializable. (Inherited from Type.)
Public propertyIsSpecialNameGets a value indicating whether the Type has a name that requires special handling. (Inherited from Type.)
Public propertyIsUnicodeClassGets a value indicating whether the string format attribute UnicodeClass is selected for the Type. (Inherited from Type.)
Public propertyIsValueTypeGets a value indicating whether the Type is a value type. (Inherited from Type.)
Public propertyIsVisibleGets a value indicating whether the Type can be accessed by code outside the assembly. (Inherited from Type.)
Public propertyMemberTypeGets a MemberTypes value indicating that this member is a type or a nested type. (Inherited from Type.)
Public propertyMetadataTokenGets a value that identifies a metadata element. (Inherited from MemberInfo.)
Public propertyModuleRetrieves the dynamic module that contains this type definition. (Overrides Type.Module.)
Public propertyNameRetrieves the name of this type. (Overrides MemberInfo.Name.)
Public propertyNamespaceRetrieves the namespace where this TypeBuilder is defined. (Overrides Type.Namespace.)
Public propertyPackingSizeRetrieves the packing size of this type.
Public propertyReflectedTypeReturns the type that was used to obtain this type. (Overrides Type.ReflectedType.)
Public propertySizeRetrieves the total size of a type.
Public propertyStructLayoutAttributeGets a StructLayoutAttribute that describes the layout of the current type. (Inherited from Type.)
Public propertyTypeHandleNot supported in dynamic modules. (Overrides Type.TypeHandle.)
Public propertyTypeInitializerGets the initializer for the Type. (Inherited from Type.)
Public propertyTypeTokenReturns the type token of this type.
Public propertyUnderlyingSystemTypeReturns the underlying system type for this TypeBuilder. (Overrides Type.UnderlyingSystemType.)
Top

  NameDescription
Public methodAddDeclarativeSecurityAdds declarative security to this type.
Public methodAddInterfaceImplementationAdds an interface that this type implements.
Public methodCreateTypeCreates a Type object for the class. After defining fields and methods on the class, CreateType is called in order to load its Type object.
Public methodDefineConstructor(MethodAttributes, CallingConventions, Type[])Adds a new constructor to the type, with the given attributes and signature.
Public methodDefineConstructor(MethodAttributes, CallingConventions, Type[], Type[][], Type[][])Adds a new constructor to the type, with the given attributes, signature, and custom modifiers.
Public methodDefineDefaultConstructorDefines the default constructor. The constructor defined here will simply call the default constructor of the parent.
Public methodDefineEventAdds a new event to the type, with the given name, attributes and event type.
Public methodDefineField(String, Type, FieldAttributes)Adds a new field to the type, with the given name, attributes, and field type.
Public methodDefineField(String, Type, Type[], Type[], FieldAttributes)Adds a new field to the type, with the given name, attributes, field type, and custom modifiers.
Public methodDefineGenericParametersDefines the generic type parameters for the current type, specifying their number and their names, and returns an array of GenericTypeParameterBuilder objects that can be used to set their constraints.
Public methodDefineInitializedDataDefines initialized data field in the .sdata section of the portable executable (PE) file.
Public methodDefineMethod(String, MethodAttributes)Adds a new method to the type, with the specified name and method attributes.
Public methodDefineMethod(String, MethodAttributes, CallingConventions)Adds a new method to the type, with the specified name, method attributes, and calling convention.
Public methodDefineMethod(String, MethodAttributes, Type, Type[])Adds a new method to the type, with the specified name, method attributes, and method signature.
Public methodDefineMethod(String, MethodAttributes, CallingConventions, Type, Type[])Adds a new method to the type, with the specified name, method attributes, calling convention, and method signature.
Public methodDefineMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])Adds a new method to the type, with the specified name, method attributes, calling convention, method signature, and custom modifiers.
Public methodDefineMethodOverrideSpecifies a given method body that implements a given method declaration, potentially with a different name.
Public methodDefineNestedType(String)Defines a nested type, given its name.
Public methodDefineNestedType(String, TypeAttributes)Defines a nested type, given its name and attributes.
Public methodDefineNestedType(String, TypeAttributes, Type)Defines a nested type, given its name, attributes, and the type that it extends.
Public methodDefineNestedType(String, TypeAttributes, Type, Int32)Defines a nested type, given its name, attributes, the total size of the type, and the type that it extends.
Public methodDefineNestedType(String, TypeAttributes, Type, PackingSize)Defines a nested type, given its name, attributes, the type that it extends, and the packing size.
Public methodDefineNestedType(String, TypeAttributes, Type, Type[])Defines a nested type, given its name, attributes, the type that it extends, and the interfaces that it implements.
Public methodDefinePInvokeMethod(String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)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.
Public methodDefinePInvokeMethod(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the name of the entry point, 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.
Public methodDefinePInvokeMethod(String, String, String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][], CallingConvention, CharSet)Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the name of the entry point, 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, the PInvoke flags, and custom modifiers for the parameters and return type.
Public methodDefineProperty(String, PropertyAttributes, Type, Type[])Adds a new property to the type, with the given name and property signature.
Public methodDefineProperty(String, PropertyAttributes, CallingConventions, Type, Type[])Adds a new property to the type, with the given name, attributes, calling convention, and property signature.
Public methodDefineProperty(String, PropertyAttributes, Type, Type[], Type[], Type[], Type[][], Type[][])Adds a new property to the type, with the given name, property signature, and custom modifiers.
Public methodDefineProperty(String, PropertyAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])Adds a new property to the type, with the given name, calling convention, property signature, and custom modifiers.
Public methodDefineTypeInitializerDefines the initializer for this type.
Public methodDefineUninitializedDataDefines an uninitialized data field in the .sdata section of the portable executable (PE) file.
Public methodEquals(Object)Determines if the underlying system type of the current Type is the same as the underlying system type of the specified Object. (Inherited from Type.)
Public methodEquals(Type)Determines if the underlying system type of the current Type is the same as the underlying system type of the specified Type. (Inherited from Type.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodFindInterfacesReturns an array of Type objects representing a filtered list of interfaces implemented or inherited by the current Type. (Inherited from Type.)
Public methodFindMembersReturns a filtered array of MemberInfo objects of the specified member type. (Inherited from Type.)
Public methodGetArrayRankGets the number of dimensions in an Array. (Inherited from Type.)
Protected methodGetAttributeFlagsImplWhen overridden in a derived class, implements the Attributes property and gets a bitmask indicating the attributes associated with the Type. (Inherited from Type.)
Public methodGetConstructor(Type[])Searches for a public instance constructor whose parameters match the types in the specified array. (Inherited from Type.)
Public methodStatic memberGetConstructor(Type, ConstructorInfo)Returns the constructor of the specified constructed generic type that corresponds to the specified constructor of the generic type definition.
Public methodGetConstructor(BindingFlags, Binder, Type[], ParameterModifier[])Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints. (Inherited from Type.)
Public methodGetConstructor(BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. (Inherited from Type.)
Protected methodGetConstructorImplWhen overridden in a derived class, searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. (Inherited from Type.)
Public methodGetConstructors()Returns all the public constructors defined for the current Type. (Inherited from Type.)
Public methodGetConstructors(BindingFlags)Returns an array of ConstructorInfo objects representing the public and non-public constructors defined for this class, as specified. (Overrides Type.GetConstructors(BindingFlags).)
Public methodGetCustomAttributes(Boolean)Returns all the custom attributes defined for this type. (Overrides MemberInfo.GetCustomAttributes(Boolean).)
Public methodGetCustomAttributes(Type, Boolean)Returns all the custom attributes of the current type that are assignable to a specified type. (Overrides MemberInfo.GetCustomAttributes(Type, Boolean).)
Public methodGetCustomAttributesDataReturns a list of CustomAttributeData objects representing data about the attributes that have been applied to the target member. (Inherited from MemberInfo.)
Public methodGetDefaultMembersSearches for the members defined for the current Type whose DefaultMemberAttribute is set. (Inherited from Type.)
Public methodGetElementTypeCalling this method always throws NotSupportedException. (Overrides Type.GetElementType().)
Public methodGetEnumNameReturns the name of the constant that has the specified value, for the current enumeration type. (Inherited from Type.)
Public methodGetEnumNamesReturns the names of the members of the current enumeration type. (Inherited from Type.)
Public methodGetEnumUnderlyingTypeReturns the underlying type of the current enumeration type. (Inherited from Type.)
Public methodGetEnumValuesReturns an array of the values of the constants in the current enumeration type. (Inherited from Type.)
Public methodGetEvent(String)Returns the EventInfo object representing the specified public event. (Inherited from Type.)
Public methodGetEvent(String, BindingFlags)Returns the event with the specified name. (Overrides Type.GetEvent(String, BindingFlags).)
Public methodGetEvents()Returns the public events declared or inherited by this type. (Overrides Type.GetEvents().)
Public methodGetEvents(BindingFlags)Returns the public and non-public events that are declared by this type. (Overrides Type.GetEvents(BindingFlags).)
Public methodGetField(String)Searches for the public field with the specified name. (Inherited from Type.)
Public methodGetField(String, BindingFlags)Returns the field specified by the given name. (Overrides Type.GetField(String, BindingFlags).)
Public methodStatic memberGetField(Type, FieldInfo)Returns the field of the specified constructed generic type that corresponds to the specified field of the generic type definition.
Public methodGetFields()Returns all the public fields of the current Type. (Inherited from Type.)
Public methodGetFields(BindingFlags)Returns the public and non-public fields that are declared by this type. (Overrides Type.GetFields(BindingFlags).)
Public methodGetGenericArgumentsReturns an array of Type objects representing the type arguments of a generic type or the type parameters of a generic type definition. (Overrides Type.GetGenericArguments().)
Public methodGetGenericParameterConstraintsReturns an array of Type objects that represent the constraints on the current generic type parameter. (Inherited from Type.)
Public methodGetGenericTypeDefinitionReturns a Type object that represents a generic type definition from which the current type can be obtained. (Overrides Type.GetGenericTypeDefinition().)
Public methodGetHashCodeReturns the hash code for this instance. (Inherited from Type.)
Public methodGetInterface(String)Searches for the interface with the specified name. (Inherited from Type.)
Public methodGetInterface(String, Boolean)Returns the interface implemented (directly or indirectly) by this class with the fully qualified name matching the given interface name. (Overrides Type.GetInterface(String, Boolean).)
Public methodGetInterfaceMapReturns an interface mapping for the requested interface. (Overrides Type.GetInterfaceMap(Type).)
Public methodGetInterfacesReturns an array of all the interfaces implemented on this type and its base types. (Overrides Type.GetInterfaces().)
Public methodGetMember(String)Searches for the public members with the specified name. (Inherited from Type.)
Public methodGetMember(String, BindingFlags)Searches for the specified members, using the specified binding constraints. (Inherited from Type.)
Public methodGetMember(String, MemberTypes, BindingFlags)Returns all the public and non-public members declared or inherited by this type, as specified. (Overrides Type.GetMember(String, MemberTypes, BindingFlags).)
Public methodGetMembers()Returns all the public members of the current Type. (Inherited from Type.)
Public methodGetMembers(BindingFlags)Returns the members for the public and non-public members declared or inherited by this type. (Overrides Type.GetMembers(BindingFlags).)
Public methodGetMethod(String)Searches for the public method with the specified name. (Inherited from Type.)
Public methodGetMethod(String, BindingFlags)Searches for the specified method, using the specified binding constraints. (Inherited from Type.)
Public methodGetMethod(String, Type[])Searches for the specified public method whose parameters match the specified argument types. (Inherited from Type.)
Public methodStatic memberGetMethod(Type, MethodInfo)Returns the method of the specified constructed generic type that corresponds to the specified method of the generic type definition.
Public methodGetMethod(String, Type[], ParameterModifier[])Searches for the specified public method whose parameters match the specified argument types and modifiers. (Inherited from Type.)
Public methodGetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints. (Inherited from Type.)
Public methodGetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. (Inherited from Type.)
Protected methodGetMethodImplWhen overridden in a derived class, searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. (Inherited from Type.)
Public methodGetMethods()Returns all the public methods of the current Type. (Inherited from Type.)
Public methodGetMethods(BindingFlags)Returns all the public and non-public methods declared or inherited by this type, as specified. (Overrides Type.GetMethods(BindingFlags).)
Public methodGetNestedType(String)Searches for the public nested type with the specified name. (Inherited from Type.)
Public methodGetNestedType(String, BindingFlags)Returns the public and non-public nested types that are declared by this type. (Overrides Type.GetNestedType(String, BindingFlags).)
Public methodGetNestedTypes()Returns the public types nested in the current Type. (Inherited from Type.)
Public methodGetNestedTypes(BindingFlags)Returns the public and non-public nested types that are declared or inherited by this type. (Overrides Type.GetNestedTypes(BindingFlags).)
Public methodGetProperties()Returns all the public properties of the current Type. (Inherited from Type.)
Public methodGetProperties(BindingFlags)Returns all the public and non-public properties declared or inherited by this type, as specified. (Overrides Type.GetProperties(BindingFlags).)
Public methodGetProperty(String)Searches for the public property with the specified name. (Inherited from Type.)
Public methodGetProperty(String, BindingFlags)Searches for the specified property, using the specified binding constraints. (Inherited from Type.)
Public methodGetProperty(String, Type)Searches for the public property with the specified name and return type. (Inherited from Type.)
Public methodGetProperty(String, Type[])Searches for the specified public property whose parameters match the specified argument types. (Inherited from Type.)
Public methodGetProperty(String, Type, Type[])Searches for the specified public property whose parameters match the specified argument types. (Inherited from Type.)
Public methodGetProperty(String, Type, Type[], ParameterModifier[])Searches for the specified public property whose parameters match the specified argument types and modifiers. (Inherited from Type.)
Public methodGetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints. (Inherited from Type.)
Protected methodGetPropertyImplWhen overridden in a derived class, searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints. (Inherited from Type.)
Public methodGetType()Gets the current Type. (Inherited from Type.)
Protected methodGetTypeCodeImplReturns the underlying type code of the specified Type. (Inherited from Type.)
Protected methodHasElementTypeImplWhen overridden in a derived class, implements the HasElementType property and determines 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. (Inherited from Type.)
Public methodInvokeMember(String, BindingFlags, Binder, Object, Object[])Invokes the specified member, using the specified binding constraints and matching the specified argument list. (Inherited from Type.)
Public methodInvokeMember(String, BindingFlags, Binder, Object, Object[], CultureInfo)Invokes the specified member, using the specified binding constraints and matching the specified argument list and culture. (Inherited from Type.)
Public methodInvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])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 constraints of the specified binder and invocation attributes. (Overrides Type.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).)
Protected methodIsArrayImplWhen overridden in a derived class, implements the IsArray property and determines whether the Type is an array. (Inherited from Type.)
Public methodIsAssignableFromDetermines whether an instance of the current Type can be assigned from an instance of the specified Type. (Overrides Type.IsAssignableFrom(Type).)
Protected methodIsByRefImplWhen overridden in a derived class, implements the IsByRef property and determines whether the Type is passed by reference. (Inherited from Type.)
Protected methodIsCOMObjectImplWhen overridden in a derived class, implements the IsCOMObject property and determines whether the Type is a COM object. (Inherited from Type.)
Protected methodIsContextfulImplImplements the IsContextful property and determines whether the Type can be hosted in a context. (Inherited from Type.)
Public methodIsCreatedReturns a value that indicates whether the current dynamic type has been created.
Public methodIsDefinedDetermines whether a custom attribute is applied to the current type. (Overrides MemberInfo.IsDefined(Type, Boolean).)
Public methodIsEnumDefinedReturns a value that indicates whether the specified value exists in the current enumeration type. (Inherited from Type.)
Public methodIsEquivalentToDetermines whether two COM types have the same identity and are eligible for type equivalence. (Inherited from Type.)
Public methodIsInstanceOfTypeDetermines whether the specified object is an instance of the current Type. (Inherited from Type.)
Protected methodIsMarshalByRefImplImplements the IsMarshalByRef property and determines whether the Type is marshaled by reference. (Inherited from Type.)
Protected methodIsPointerImplWhen overridden in a derived class, implements the IsPointer property and determines whether the Type is a pointer. (Inherited from Type.)
Protected methodIsPrimitiveImplWhen overridden in a derived class, implements the IsPrimitive property and determines whether the Type is one of the primitive types. (Inherited from Type.)
Public methodIsSubclassOfDetermines whether this type is derived from a specified type. (Overrides Type.IsSubclassOf(Type).)
Protected methodIsValueTypeImplImplements the IsValueType property and determines whether the Type is a value type; that is, not a class or an interface. (Inherited from Type.)
Public methodMakeArrayType()Returns a Type object that represents a one-dimensional array of the current type, with a lower bound of zero. (Overrides Type.MakeArrayType().)
Public methodMakeArrayType(Int32)Returns a Type object that represents an array of the current type, with the specified number of dimensions. (Overrides Type.MakeArrayType(Int32).)
Public methodMakeByRefTypeReturns a Type object that represents the current type when passed as a ref parameter (ByRef in Visual Basic). (Overrides Type.MakeByRefType().)
Public methodMakeGenericTypeSubstitutes the elements of an array of types for the type parameters of the current generic type definition, and returns the resulting constructed type. (Overrides Type.MakeGenericType(Type[]).)
Public methodMakePointerTypeReturns a Type object that represents the type of an unmanaged pointer to the current type. (Overrides Type.MakePointerType().)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSetCustomAttribute(CustomAttributeBuilder)Set a custom attribute using a custom attribute builder.
Public methodSetCustomAttribute(ConstructorInfo, Byte[])Sets a custom attribute using a specified custom attribute blob.
Public methodSetParentSets the base type of the type currently under construction.
Public methodToStringReturns the name of the type excluding the namespace. (Overrides Type.ToString().)
Top

  NameDescription
Public fieldStatic memberUnspecifiedTypeSizeRepresents that total size for the type is not specified.
Top

  NameDescription
Explicit interface implemetationPrivate method_MemberInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeGets a Type object representing the MemberInfo class. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.InvokeProvides access to properties and methods exposed by an object. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_Type.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from Type.)
Explicit interface implemetationPrivate method_Type.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from Type.)
Explicit interface implemetationPrivate method_Type.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from Type.)
Explicit interface implemetationPrivate method_Type.InvokeProvides access to properties and methods exposed by an object. (Inherited from Type.)
Explicit interface implemetationPrivate method_TypeBuilder.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers.
Explicit interface implemetationPrivate method_TypeBuilder.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface.
Explicit interface implemetationPrivate method_TypeBuilder.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1).
Explicit interface implemetationPrivate method_TypeBuilder.InvokeProvides access to properties and methods exposed by an object.
Top

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 create an array type, pointer type, or byref type for an incomplete type that is represented by a TypeBuilder object, use the MakeArrayType method, MakePointerType method, or MakeByRefType method, respectively.

NoteNote

The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: MayLeakOnAbort. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

This section contains two code examples. The first example shows how to create a dynamic type with a field, constructor, property, and method. The second example builds a method dynamically from user input.

Example one

The following code example shows how to define a dynamic assembly with one module. The module in the example assembly contains one type, MyDynamicType, which has a private field, a property that gets and sets the private field, constructors that initialize the private field, and a method that multiplies a user-supplied number by the private field value and returns the result.

The AssemblyBuilderAccess.RunAndSave field is specified when the assembly is created. The assembly code is used immediately, and the assembly is also saved to disk so that it can be examined with Ildasm.exe (MSIL Disassembler) or used in another program.


using System;
using System.Reflection;
using System.Reflection.Emit;

class DemoAssemblyBuilder
{
    public static void Main()
    {
        // An assembly consists of one or more modules, each of which
        // contains zero or more types. This code creates a single-module
        // assembly, the most common case. The module contains one type,
        // named "MyDynamicType", that has a private field, a property 
        // that gets and sets the private field, constructors that 
        // initialize the private field, and a method that multiplies 
        // a user-supplied number by the private field value and returns
        // the result. In C# the type might look like this:
        /*
        public class MyDynamicType
        {
            private int m_number;

            public MyDynamicType() : this(42) {}
            public MyDynamicType(int initNumber)
            {
                m_number = initNumber;
            }

            public int Number
            {
                get { return m_number; }
                set { m_number = value; }
            }

            public int MyMethod(int multiplier)
            {
                return m_number * multiplier;
            }
        }
        */

        AssemblyName aName = new AssemblyName("DynamicAssemblyExample");
        AssemblyBuilder ab = 
            AppDomain.CurrentDomain.DefineDynamicAssembly(
                aName, 
                AssemblyBuilderAccess.RunAndSave);

        // For a single-module assembly, the module name is usually
        // the assembly name plus an extension.
        ModuleBuilder mb = 
            ab.DefineDynamicModule(aName.Name, aName.Name + ".dll");

        TypeBuilder tb = mb.DefineType(
            "MyDynamicType", 
             TypeAttributes.Public);

        // Add a private field of type int (Int32).
        FieldBuilder fbNumber = tb.DefineField(
            "m_number", 
            typeof(int), 
            FieldAttributes.Private);

        // Define a constructor that takes an integer argument and 
        // stores it in the private field. 
        Type[] parameterTypes = { typeof(int) };
        ConstructorBuilder ctor1 = tb.DefineConstructor(
            MethodAttributes.Public, 
            CallingConventions.Standard, 
            parameterTypes);

        ILGenerator ctor1IL = ctor1.GetILGenerator();
        // For a constructor, argument zero is a reference to the new
        // instance. Push it on the stack before calling the base
        // class constructor. Specify the default constructor of the 
        // base class (System.Object) by passing an empty array of 
        // types (Type.EmptyTypes) to GetConstructor.
        ctor1IL.Emit(OpCodes.Ldarg_0);
        ctor1IL.Emit(OpCodes.Call, 
            typeof(object).GetConstructor(Type.EmptyTypes));
        // Push the instance on the stack before pushing the argument
        // that is to be assigned to the private field m_number.
        ctor1IL.Emit(OpCodes.Ldarg_0);
        ctor1IL.Emit(OpCodes.Ldarg_1);
        ctor1IL.Emit(OpCodes.Stfld, fbNumber);
        ctor1IL.Emit(OpCodes.Ret);

        // Define a default constructor that supplies a default value
        // for the private field. For parameter types, pass the empty
        // array of types or pass null.
        ConstructorBuilder ctor0 = tb.DefineConstructor(
            MethodAttributes.Public, 
            CallingConventions.Standard, 
            Type.EmptyTypes);

        ILGenerator ctor0IL = ctor0.GetILGenerator();
        // For a constructor, argument zero is a reference to the new
        // instance. Push it on the stack before pushing the default
        // value on the stack, then call constructor ctor1.
        ctor0IL.Emit(OpCodes.Ldarg_0);
        ctor0IL.Emit(OpCodes.Ldc_I4_S, 42);
        ctor0IL.Emit(OpCodes.Call, ctor1);
        ctor0IL.Emit(OpCodes.Ret);

        // Define a property named Number that gets and sets the private 
        // field.
        //
        // The last argument of DefineProperty is null, because the
        // property has no parameters. (If you don't specify null, you must
        // specify an array of Type objects. For a parameterless property,
        // use the built-in array with no elements: Type.EmptyTypes)
        PropertyBuilder pbNumber = tb.DefineProperty(
            "Number", 
            PropertyAttributes.HasDefault, 
            typeof(int), 
            null);

        // The property "set" and property "get" methods require a special
        // set of attributes.
        MethodAttributes getSetAttr = MethodAttributes.Public | 
            MethodAttributes.SpecialName | MethodAttributes.HideBySig;

        // Define the "get" accessor method for Number. The method returns
        // an integer and has no arguments. (Note that null could be 
        // used instead of Types.EmptyTypes)
        MethodBuilder mbNumberGetAccessor = tb.DefineMethod(
            "get_Number", 
            getSetAttr, 
            typeof(int), 
            Type.EmptyTypes);

        ILGenerator numberGetIL = mbNumberGetAccessor.GetILGenerator();
        // For an instance property, argument zero is the instance. Load the 
        // instance, then load the private field and return, leaving the
        // field value on the stack.
        numberGetIL.Emit(OpCodes.Ldarg_0);
        numberGetIL.Emit(OpCodes.Ldfld, fbNumber);
        numberGetIL.Emit(OpCodes.Ret);

        // Define the "set" accessor method for Number, which has no return
        // type and takes one argument of type int (Int32).
        MethodBuilder mbNumberSetAccessor = tb.DefineMethod(
            "set_Number", 
            getSetAttr, 
            null, 
            new Type[] { typeof(int) });

        ILGenerator numberSetIL = mbNumberSetAccessor.GetILGenerator();
        // Load the instance and then the numeric argument, then store the
        // argument in the field.
        numberSetIL.Emit(OpCodes.Ldarg_0);
        numberSetIL.Emit(OpCodes.Ldarg_1);
        numberSetIL.Emit(OpCodes.Stfld, fbNumber);
        numberSetIL.Emit(OpCodes.Ret);

        // Last, map the "get" and "set" accessor methods to the 
        // PropertyBuilder. The property is now complete. 
        pbNumber.SetGetMethod(mbNumberGetAccessor);
        pbNumber.SetSetMethod(mbNumberSetAccessor);

        // Define a method that accepts an integer argument and returns
        // the product of that integer and the private field m_number. This
        // time, the array of parameter types is created on the fly.
        MethodBuilder meth = tb.DefineMethod(
            "MyMethod", 
            MethodAttributes.Public, 
            typeof(int), 
            new Type[] { typeof(int) });

        ILGenerator methIL = meth.GetILGenerator();
        // To retrieve the private instance field, load the instance it
        // belongs to (argument zero). After loading the field, load the 
        // argument one and then multiply. Return from the method with 
        // the return value (the product of the two numbers) on the 
        // execution stack.
        methIL.Emit(OpCodes.Ldarg_0);
        methIL.Emit(OpCodes.Ldfld, fbNumber);
        methIL.Emit(OpCodes.Ldarg_1);
        methIL.Emit(OpCodes.Mul);
        methIL.Emit(OpCodes.Ret);

        // Finish the type.
        Type t = tb.CreateType();

        // The following line saves the single-module assembly. This
        // requires AssemblyBuilderAccess to include Save. You can now
        // type "ildasm MyDynamicAsm.dll" at the command prompt, and 
        // examine the assembly. You can also write a program that has
        // a reference to the assembly, and use the MyDynamicType type.
        // 
        ab.Save(aName.Name + ".dll");

        // Because AssemblyBuilderAccess includes Run, the code can be
        // executed immediately. Start by getting reflection objects for
        // the method and the property.
        MethodInfo mi = t.GetMethod("MyMethod");
        PropertyInfo pi = t.GetProperty("Number");

        // Create an instance of MyDynamicType using the default 
        // constructor. 
        object o1 = Activator.CreateInstance(t);

        // Display the value of the property, then change it to 127 and 
        // display it again. Use null to indicate that the property
        // has no index.
        Console.WriteLine("o1.Number: {0}", pi.GetValue(o1, null));
        pi.SetValue(o1, 127, null);
        Console.WriteLine("o1.Number: {0}", pi.GetValue(o1, null));

        // Call MyMethod, passing 22, and display the return value, 22
        // times 127. Arguments must be passed as an array, even when
        // there is only one.
        object[] arguments = { 22 };
        Console.WriteLine("o1.MyMethod(22): {0}", 
            mi.Invoke(o1, arguments));

        // Create an instance of MyDynamicType using the constructor
        // that specifies m_Number. The constructor is identified by
        // matching the types in the argument array. In this case, 
        // the argument array is created on the fly. Display the 
        // property value.
        object o2 = Activator.CreateInstance(t, 
            new object[] { 5280 });
        Console.WriteLine("o2.Number: {0}", pi.GetValue(o2, null));
    }
}

/* This code produces the following output:

o1.Number: 42
o1.Number: 127
o1.MyMethod(22): 2794
o2.Number: 5280
 */


Example two

The following code sample demonstrates how to build a dynamic type by using TypeBuilder.



using System;
using System.Threading;
using System.Reflection;
using System.Reflection.Emit;


class TestILGenerator {

  	public static Type DynamicDotProductGen() {
	  
	   Type ivType = null;
	   Type[] ctorParams = new Type[] { typeof(int),
		               		    typeof(int),
					    typeof(int)};
 	
	   AppDomain myDomain = Thread.GetDomain();
	   AssemblyName myAsmName = new AssemblyName();
	   myAsmName.Name = "IntVectorAsm";
	
	   AssemblyBuilder myAsmBuilder = myDomain.DefineDynamicAssembly(
					  myAsmName, 
					  AssemblyBuilderAccess.RunAndSave);

   	   ModuleBuilder IntVectorModule = myAsmBuilder.DefineDynamicModule("IntVectorModule",
									    "Vector.dll");

	   TypeBuilder ivTypeBld = IntVectorModule.DefineType("IntVector",
						              TypeAttributes.Public);

	   FieldBuilder xField = ivTypeBld.DefineField("x", typeof(int),
                                                       FieldAttributes.Private);
	   FieldBuilder yField = ivTypeBld.DefineField("y", typeof(int), 
                                                       FieldAttributes.Private);
	   FieldBuilder zField = ivTypeBld.DefineField("z", typeof(int),
                                                       FieldAttributes.Private);


           Type objType = Type.GetType("System.Object"); 
           ConstructorInfo objCtor = objType.GetConstructor(new Type[0]);

	   ConstructorBuilder ivCtor = ivTypeBld.DefineConstructor(
					  MethodAttributes.Public,
					  CallingConventions.Standard,
					  ctorParams);
	   ILGenerator ctorIL = ivCtor.GetILGenerator();
           ctorIL.Emit(OpCodes.Ldarg_0);
           ctorIL.Emit(OpCodes.Call, objCtor);
           ctorIL.Emit(OpCodes.Ldarg_0);
           ctorIL.Emit(OpCodes.Ldarg_1);
           ctorIL.Emit(OpCodes.Stfld, xField); 
           ctorIL.Emit(OpCodes.Ldarg_0);
           ctorIL.Emit(OpCodes.Ldarg_2);
           ctorIL.Emit(OpCodes.Stfld, yField); 
           ctorIL.Emit(OpCodes.Ldarg_0);
           ctorIL.Emit(OpCodes.Ldarg_3);
           ctorIL.Emit(OpCodes.Stfld, zField); 
	   ctorIL.Emit(OpCodes.Ret); 


	   // This method will find the dot product of the stored vector
	   // with another.

	   Type[] dpParams = new Type[] { ivTypeBld };

           // Here, you create a MethodBuilder containing the
	   // name, the attributes (public, static, private, and so on),
	   // the return type (int, in this case), and a array of Type
	   // indicating the type of each parameter. Since the sole parameter
	   // is a IntVector, the very class you're creating, you will
	   // pass in the TypeBuilder (which is derived from Type) instead of 
	   // a Type object for IntVector, avoiding an exception. 

	   // -- This method would be declared in C# as:
	   //    public int DotProduct(IntVector aVector)

           MethodBuilder dotProductMthd = ivTypeBld.DefineMethod(
	    		                  "DotProduct", 
				          MethodAttributes.Public,
                                          typeof(int), 
                                          dpParams);

	   // A ILGenerator can now be spawned, attached to the MethodBuilder.

	   ILGenerator mthdIL = dotProductMthd.GetILGenerator();
	   
 	   // Here's the body of our function, in MSIL form. We're going to find the
	   // "dot product" of the current vector instance with the passed vector 
	   // instance. For reference purposes, the equation is:
	   // (x1 * x2) + (y1 * y2) + (z1 * z2) = the dot product

	   // First, you'll load the reference to the current instance "this"
	   // stored in argument 0 (ldarg.0) onto the stack. Ldfld, the subsequent
	   // instruction, will pop the reference off the stack and look up the
	   // field "x", specified by the FieldInfo token "xField".

	   mthdIL.Emit(OpCodes.Ldarg_0);
	   mthdIL.Emit(OpCodes.Ldfld, xField);

	   // That completed, the value stored at field "x" is now atop the stack.
	   // Now, you'll do the same for the object reference we passed as a
	   // parameter, stored in argument 1 (ldarg.1). After Ldfld executed,
	   // you'll have the value stored in field "x" for the passed instance
	   // atop the stack.

	   mthdIL.Emit(OpCodes.Ldarg_1);
	   mthdIL.Emit(OpCodes.Ldfld, xField);

           // There will now be two values atop the stack - the "x" value for the
	   // current vector instance, and the "x" value for the passed instance.
	   // You'll now multiply them, and push the result onto the evaluation stack.

	   mthdIL.Emit(OpCodes.Mul_Ovf_Un);

	   // Now, repeat this for the "y" fields of both vectors.

	   mthdIL.Emit(OpCodes.Ldarg_0);
	   mthdIL.Emit(OpCodes.Ldfld, yField);
	   mthdIL.Emit(OpCodes.Ldarg_1);
	   mthdIL.Emit(OpCodes.Ldfld, yField);
	   mthdIL.Emit(OpCodes.Mul_Ovf_Un);

	   // At this time, the results of both multiplications should be atop
	   // the stack. You'll now add them and push the result onto the stack.

	   mthdIL.Emit(OpCodes.Add_Ovf_Un);

	   // Multiply both "z" field and push the result onto the stack.
	   mthdIL.Emit(OpCodes.Ldarg_0);
	   mthdIL.Emit(OpCodes.Ldfld, zField);
	   mthdIL.Emit(OpCodes.Ldarg_1);
	   mthdIL.Emit(OpCodes.Ldfld, zField);
	   mthdIL.Emit(OpCodes.Mul_Ovf_Un);

	   // Finally, add the result of multiplying the "z" fields with the
	   // result of the earlier addition, and push the result - the dot product -
	   // onto the stack.
	   mthdIL.Emit(OpCodes.Add_Ovf_Un);

	   // The "ret" opcode will pop the last value from the stack and return it
	   // to the calling method. You're all done!

	   mthdIL.Emit(OpCodes.Ret);


 	   ivType = ivTypeBld.CreateType();

	   return ivType;

 	}

	public static void Main() {
	
	   Type IVType = null;
           object aVector1 = null;
           object aVector2 = null;
	   Type[] aVtypes = new Type[] {typeof(int), typeof(int), typeof(int)};
           object[] aVargs1 = new object[] {10, 10, 10};
           object[] aVargs2 = new object[] {20, 20, 20};
	
	   // Call the  method to build our dynamic class.

	   IVType = DynamicDotProductGen();

           Console.WriteLine("---");

	   ConstructorInfo myDTctor = IVType.GetConstructor(aVtypes);
	   aVector1 = myDTctor.Invoke(aVargs1);
	   aVector2 = myDTctor.Invoke(aVargs2);

	   object[] passMe = new object[1];
           passMe[0] = (object)aVector2; 

	   Console.WriteLine("(10, 10, 10) . (20, 20, 20) = {0}",
			     IVType.InvokeMember("DotProduct",
						  BindingFlags.InvokeMethod,
						  null,
						  aVector1,
						  passMe));

	    

	   // +++ OUTPUT +++
	   // ---
	   // (10, 10, 10) . (20, 20, 20) = 600 
	    
	}

}



.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft