This documentation is archived and is not being maintained.

ModuleBuilder.GetArrayMethodToken Method

Returns the token for the named method on an array class.

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

'Declaration
Public Function GetArrayMethodToken ( _
	arrayClass As Type, _
	methodName As String, _
	callingConvention As CallingConventions, _
	returnType As Type, _
	parameterTypes As Type() _
) As MethodToken

Parameters

arrayClass
Type: System.Type
The object for the array.
methodName
Type: System.String
A string that contains the name of the method.
callingConvention
Type: System.Reflection.CallingConventions
The calling convention for the method.
returnType
Type: System.Type
The return type of the method.
parameterTypes
Type: System.Type()
The types of the parameters of the method.

Return Value

Type: System.Reflection.Emit.MethodToken
The token for the named method on an array class.

ExceptionCondition
ArgumentException

arrayClass is not an array.

-or-

The length of methodName is zero.

ArgumentNullException

arrayClass or methodName is Nothing.

This method is similar to GetArrayMethod, except that it returns the token of the array method instead of the method itself.

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


' Define a dynamic module in "TempAssembly" assembly.
Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")
' Define a runtime class with specified name and attributes.
Dim myTypeBuilder As TypeBuilder = _
            myModuleBuilder.DefineType("TempClass", TypeAttributes.Public)
Dim myParamArray() As Type = New Type() {GetType(Array)}
' Add 'SortArray' method to the class, with the given signature.
Dim myMethod As MethodBuilder = _
   myTypeBuilder.DefineMethod("SortArray", MethodAttributes.Public, _
   GetType(Array), myParamArray)

Dim myArrayClass(0) As Type
Dim parameterTypes() As Type = New Type() {GetType(Array)}
' Get the 'MethodInfo' object corresponding to 'Sort' method of 'Array' class.
Dim myMethodInfo As MethodInfo = _
   myModuleBuilder.GetArrayMethod(myArrayClass.GetType(), "Sort", _
   CallingConventions.Standard, Nothing, parameterTypes)
' Get the token corresponding to 'Sort' method of 'Array' class.
Dim myMethodToken As MethodToken = _
      myModuleBuilder.GetArrayMethodToken(myArrayClass.GetType(), _
      "Sort", CallingConventions.Standard, Nothing, parameterTypes)
Console.WriteLine("Token used by module to identify the 'Sort' method" + _
                  " of 'Array' class is : {0:x} ", myMethodToken.Token)
Dim methodIL As ILGenerator = 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.
myTypeBuilder.CreateType()


.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.
Show: