OpCodes.Ldelem_Ref Champ

Définition

Espace de noms:

System.Reflection.Emit

Assembly:

System.Reflection.Primitives.dll

Source:

OpCodes.cs

Charge l'élément contenant une référence d'objet à un index de tableau spécifié en haut de la pile d'évaluation en tant que type O (référence d'objet).

public: static initonly System::Reflection::Emit::OpCode Ldelem_Ref;

public static readonly System.Reflection.Emit.OpCode Ldelem_Ref;

 staticval mutable Ldelem_Ref : System.Reflection.Emit.OpCode

Public Shared ReadOnly Ldelem_Ref As OpCode 

Valeur de champ

OpCode

Remarques

Le tableau suivant répertorie le format d’assembly MSIL et hexadécimal de l’instruction, ainsi qu’un bref résumé des références :

Format	Format d’assembly	Description
9A	ldelem.ref	Charge l’élément avec une référence d’objet en index haut de la pile en tant que type O.

Le comportement transitoire de la pile, dans l’ordre séquentiel, est le suivant :

1. Une référence array d’objet est envoyée sur la pile.

2. Une valeur index d’index est envoyée à la pile.

3. index et array sont extraits de la pile ; la valeur stockée à la position index dans array est recherchée.

4. La valeur est poussée vers la pile.

L’instruction ldelem.ref charge la valeur de l’élément avec index index (type native int) dans le tableau array unidimensionnel de base zéro et le place en haut de la pile. Les tableaux sont des objets et sont donc représentés par une valeur de type O.

La valeur de retour pour ldelem.ref est type O (référence d’objet).

NullReferenceException est levée si array est une référence null.

ArrayTypeMismatchException est levée si array ne contient pas d’éléments du type requis.

IndexOutOfRangeException est levée si index est négatif ou supérieur à la limite de array.

La surcharge de méthode suivante Emit peut utiliser l’opcode ldelem.ref :

• ILGenerator.Emit(OpCode)