OpCodes.Ldelem_Ref Champ

Définition

Espace de noms:

System.Reflection.Emit

Assembly:

System.Reflection.Primitives.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

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 hexadécimal et Microsoft Intermediate Language (MSIL) de l’instruction, ainsi qu’un bref résumé de référence :

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 de transition de 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 sur la pile.

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

4. La valeur est envoyée sur 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 la place en haut de la pile. Les tableaux sont des objets et, par conséquent, représentés par une valeur de type O.

Valeur de retour pour ldelem.ref le type O (référence d’objet).

NullReferenceException est levée s’il array s’agit d’une référence Null.

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

IndexOutOfRangeException est levée si index elle est négative ou supérieure à la limite de array.

La surcharge de méthode suivante Emit peut utiliser le ldelem.ref code opcode :

• ILGenerator.Emit(OpCode)