OpCodes.Newarr Champ

Définition

Espace de noms:
System.Reflection.Emit
Assemblys:
mscorlib.dll, System.Reflection.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
System.Reflection.Primitives.dll
Assembly:
netstandard.dll

Envoie une référence d’objet à un nouveau tableau unidimensionnel de base zéro dont les éléments sont d’un type spécifique sur la pile d’évaluation.

public: static initonly System::Reflection::Emit::OpCode Newarr;
public static readonly System.Reflection.Emit.OpCode Newarr;
 staticval mutable Newarr : System.Reflection.Emit.OpCode
Public Shared ReadOnly Newarr As OpCode

Valeur de champ

OpCode

Remarques

Le tableau suivant répertorie le format d'assembly MSIL (Hexadécimal et Microsoft Intermediate Language) de l'instruction, ainsi qu'un bref résumé de référence :

Format Format d’assembly Description
8D <T> newarr etype Crée un tableau avec des éléments de type etype.

Le comportement transitionnel de la pile, dans l’ordre séquentiel, est :

  1. Le nombre d’éléments du tableau est envoyé (push) sur la pile.

  2. Le nombre d’éléments est extrait de la pile et le tableau est créé.

  3. Une référence d’objet au nouveau tableau est envoyée (push) sur la pile.

L’instruction newarr envoie une référence d’objet (type O) à un nouveau tableau unidimensionnel de base zéro dont les éléments sont de type etype (un jeton de métadonnées décrivant le type). Le nombre d’éléments dans le nouveau tableau doit être spécifié en tant que native int. Les index de tableau valides sont compris entre zéro et le nombre maximal d’éléments moins un.

Les éléments d’un tableau peuvent être n’importe quel type, y compris les types valeur.

Les tableaux unidimensionnels de nombres basés sur zéro sont créés à l’aide d’un jeton de métadonnées référençant le type de valeur approprié (Int32et ainsi de suite). Les éléments du tableau sont initialisés à 0 du type approprié.

Les tableaux unidimensionnels et les tableaux multidimensionnels non basés sur zéro sont créés à l’aide Newobj plutôt que newarr. Plus souvent, ils sont créés à l’aide des méthodes de la classe Array dans le framework .NET.

OutOfMemoryException est levée en cas d’insuffisance de mémoire pour satisfaire la demande.

OverflowException est levée si numElems elle est inférieure à 0.

La surcharge de méthode suivante Emit peut utiliser l’opcode newarr :

S’applique à