This documentation is archived and is not being maintained.

OpCodes.Ldlen Field

Pushes the number of elements of a zero-based, one-dimensional array onto the evaluation stack.

[Visual Basic]
Public Shared ReadOnly Ldlen As OpCode
public static readonly OpCode Ldlen;
public: static OpCode Ldlen;
public static var Ldlen : OpCode;


The following table lists the instruction's hexadecimal and Microsoft Intermediate Language (MSIL) assembly format, along with a brief reference summary:

Format Assembly Format Description
8E ldlen Pushes the length (of type natural unsigned int) of an array on the stack.

The stack transitional behavior, in sequential order, is:

  1. An object reference to an array is pushed onto the stack.
  2. The array referenceis popped from the stack and the length is computed.
  3. The length is pushed onto the stack.

Arrays are objects and hence represented by a value of type O. The length is returned as a natural unsigned int.

NullReferenceException is thrown if the array reference is a null reference.

The following Emit constructor overload can use the ldlen opcode:

  • ILGenerator.Emit(OpCode)


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

OpCodes Class | OpCodes Members | System.Reflection.Emit Namespace