Pushes the number of elements of a zero-based, one-dimensional array onto the evaluation stack.
[Visual Basic] Public Shared ReadOnly Ldlen As OpCode [C#] public static readonly OpCode Ldlen; [C++] public: static OpCode Ldlen; [JScript] 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:
|8E||ldlen||Pushes the length (of type natural unsigned int) of an array on the stack.|
The stack transitional behavior, in sequential order, is:
- An object reference to an array is pushed onto the stack.
- The array referenceis popped from the stack and the length is computed.
- 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:
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family