OpCodes.Ldelem Field
Loads the element at a specified array index onto the top of the evaluation stack as the type specified in the instruction.
Namespace: System.Reflection.Emit
Assembly: mscorlib (in mscorlib.dll)
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 |
|---|---|---|
|
A3 < T > |
ldelem typeTok |
Loads the element at index onto the top of the stack as type typeTok. |
The stack transitional behavior, in sequential order, is:
-
An object reference array is pushed onto the stack.
-
An index value index is pushed onto the stack.
-
index and array are popped from the stack; the value stored at position index in array is looked up.
-
The value is pushed onto the stack.
The ldelem instruction loads the value of the element with index index (type native int) in the zero-based one-dimensional array array and places it on the top of the stack. Arrays are objects, and hence represented by a value of type O.
The type of the return value is specified by the token typeTok in the instruction.
NullReferenceException is thrown if array is a null reference.
IndexOutOfRangeException is thrown if index is negative, or larger than the upper bound of array.
The following Emit method overload can use the ldelem opcode:
-
ILGenerator.Emit(OpCode, Type)
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
