This documentation is archived and is not being maintained.

TypeBuilder.MakeGenericType Method

Substitutes the elements of an array of types for the type parameters of the current generic type definition, and returns the resulting constructed type.

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

public override Type MakeGenericType(
	params Type[] typeArguments
)

Parameters

typeArguments
Type: System.Type[]

An array of types to be substituted for the type parameters of the current generic type definition.

Return Value

Type: System.Type
A Type representing the constructed type formed by substituting the elements of typeArguments for the type parameters of the current generic type.

ExceptionCondition
InvalidOperationException

The current type does not represent the definition of a generic type. That is, IsGenericTypeDefinition returns false.

ArgumentNullException

typeArguments is null.

-or-

Any element of typeArguments is null.

ArgumentException

Any element of typeArguments does not satisfy the constraints specified for the corresponding type parameter of the current generic type.

Use this method when your emitted code requires a type constructed from the current generic type definition. It is not necessary to call the CreateType method before calling the MakeGenericType method on a TypeBuilder that represents a generic type definition. If the current TypeBuilder does not represent the definition of a generic type, an InvalidOperationException is thrown.

The object returned by this method functions as a placeholder for a constructed generic type in your emitted code. It is an instance of a class derived from Type that has limited capabilities. In particular:

  • To get methods, fields, and constructors for these constructed generic types, use the GetMethod(Type, MethodInfo), GetField(Type, FieldInfo), and GetConstructor(Type, ConstructorInfo) method overloads.

  • Two instances that represent the same constructed type do not compare as equal. For example, in the following code t1.Equals(t2) returns false:

    Dim t1 As Type = tbldr.MakeGenericType(GetType(String))
    Dim t2 As Type = tbldr.MakeGenericType(GetType(String))
    Dim result As Boolean = t1.Equals(t2)
    

    Type t1 = tbldr.MakeGenericType(typeof(string));
    Type t2 = tbldr.MakeGenericType(typeof(string));
    bool result = t1.Equals(t2);
    

    Type^ t1 = tbldr->MakeGenericType(String::typeid);
    Type^ t2 = tbldr->MakeGenericType(String::typeid);
    bool result = t1->Equals(t2);
    

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: