ModuleBuilder::GetArrayMethod Method (Type^, String^, CallingConventions, Type^, array<Type^>^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Returns the named method on an array class.

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

MethodInfo^ GetArrayMethod(
	Type^ arrayClass,
	String^ methodName,
	CallingConventions callingConvention,
	Type^ returnType,
	array<Type^>^ parameterTypes


Type: System::Type^

An array class.

Type: System::String^

The name of a method on the array class.

Type: System.Reflection::CallingConventions

The method's calling convention.

Type: System::Type^

The return type of the method.

Type: array<System::Type^>^

The types of the method's parameters.

Return Value

Type: System.Reflection::MethodInfo^

The named method on an array class.

Exception Condition

arrayClass is not an array.


arrayClass or methodName is null.

GetArrayMethod is useful when you have an array of a type whose definition has not been completed and you want to access methods defined on Array. For example, you might define a type and want to define a method that takes an array of the type as a parameter. In order to access the elements of the array, you will need to call methods of the Array class.

The following example demonstrates how to use GetArrayMethod to obtain the MethodInfo corresponding to a method that returns an array value.

// Define a dynamic module in "TempAssembly" assembly.
ModuleBuilder^ myModuleBuilder = myAssemblyBuilder->
   DefineDynamicModule( "TempModule" );

// Define a runtime class with specified name and attributes.
TypeBuilder^ myTypeBuilder = myModuleBuilder->DefineType(
   "TempClass", TypeAttributes::Public );
array<Type^>^ paramArray = { Array::typeid };
// Add 'SortArray' method to the class, with the given signature.
MethodBuilder^ myMethod = myTypeBuilder->DefineMethod( "SortArray",
   MethodAttributes::Public, Array::typeid, paramArray );

array<Type^>^ myArrayClass = gcnew array<Type^>( 1 );
array<Type^>^ parameterTypes = { Array::typeid };
// Get the 'MethodInfo' object corresponding to 'Sort' method of 'Array' class.
MethodInfo^ myMethodInfo = myModuleBuilder->GetArrayMethod(
   myArrayClass->GetType(), "Sort", CallingConventions::Standard,
   nullptr, parameterTypes );

// Get the token corresponding to 'Sort' method of 'Array' class.
MethodToken myMethodToken = myModuleBuilder->GetArrayMethodToken(
   myArrayClass->GetType(), "Sort", CallingConventions::Standard,
   nullptr, parameterTypes );
Console::WriteLine( "Token used by module to identify the 'Sort' method"
   + " of 'Array' class is : {0:x} ", myMethodToken.Token );

ILGenerator^ methodIL = myMethod->GetILGenerator();
methodIL->Emit( OpCodes::Ldarg_1 );
methodIL->Emit( OpCodes::Call, myMethodInfo );
methodIL->Emit( OpCodes::Ldarg_1 );
methodIL->Emit( OpCodes::Ret );

// Complete the creation of type.

.NET Framework
Available since 1.1
Available since 2.0
Return to top