OpCodes.Ldlen Field

Definition

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

C#
public static readonly System.Reflection.Emit.OpCode Ldlen;

Field Value

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:

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0