Freigeben über


OpCodes.Ldelem_Ref-Feld

Lädt das Element mit Objektverweis an einem angegebenen Arrayindex als Typ O (Objektverweis) an die oberste Position des Auswertungsstapels.

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

Syntax

'Declaration
Public Shared ReadOnly Ldelem_Ref As OpCode
'Usage
Dim value As OpCode

value = OpCodes.Ldelem_Ref
public static readonly OpCode Ldelem_Ref
public:
static initonly OpCode Ldelem_Ref
public static final OpCode Ldelem_Ref
public static final var Ldelem_Ref : OpCode

Hinweise

In der folgenden Tabelle werden das hexadezimale und das Assemblyformat der MSIL (Microsoft Intermediate Language) jeweils mit einer Kurzreferenz aufgeführt:

Format

Assemblyformat

Beschreibung

9A

ldelem.ref

Lädt das Element mit Objektverweis am index als Typ O an die oberste Position des Stapels.

Im Stapel laufen die folgenden Aktionen in der angegebenen Reihenfolge ab:

  1. Der Objektverweis array wird auf dem Stapel abgelegt.

  2. Ein Indexwert index wird auf dem Stapel abgelegt.

  3. index und array werden vom Stapel geholt. Der an der Position index in array gespeicherte Wert wird gesucht.

  4. Der Wert wird auf dem Stapel abgelegt.

Die ldelem.ref-Anweisung lädt den Wert des Elements mit dem Index index (Typ natural int) im nullbasierten eindimensionalen Array array und legt ihn auf die oberste Position des Stapels. Arrays sind Objekte und können daher als Wert vom Typ O dargestellt werden.

DerRückgabewert für ldelem.ref ist vom Typ O (Objektverweis).

NullReferenceException wird ausgelöst, wenn array ein NULL-Verweis ist.

ArrayTypeMismatchException wird ausgelöst, wenn array keine Elemente des erforderlichen Typs enthält.

IndexOutOfRangeException wird ausgelöst, wenn der index negativ oder größer als die Begrenzung von array ist.

Die folgende Überladung der Emit-Methode verwendet den ldelem.ref-Opcode:

  • ILGenerator.Emit(OpCode)

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

OpCodes-Klasse
OpCodes-Member
System.Reflection.Emit-Namespace