OpCodes.Ldlen Field

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Shared ReadOnly Ldlen As OpCode
public static readonly OpCode Ldlen

Remarks

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 reference is 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 method overload can use the ldlen opcode:

  • ILGenerator.Emit(OpCode)

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.