Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

OpCodes.Box champ

 

Date de publication : novembre 2016

Convertit un type valeur en une référence d’objet (type O).

Espace de noms:   System.Reflection.Emit
Assembly:  mscorlib (dans mscorlib.dll)

public static readonly OpCode Box

Valeur de champ

Type: System.Reflection.Emit.OpCode

Le tableau suivant répertorie des instructions format hexadécimal et langage MSIL (Microsoft Intermediate Language) assembly, ainsi qu'un résumé des informations de référence :

Format

Format de l'assembly

Description

8C < T >

zone valTypeToken

Convertit un type valeur (du type spécifié dans valTypeToken) pour une référence d’objet true.

Le comportement de transition de pile, dans un ordre séquentiel, est :

  1. Un type valeur est envoyé à la pile.

  2. Le type de valeur est extraite de la pile ; le box opération est effectuée.

  3. Le type de valeur « boxed » obtenu une référence d’objet est placée sur la pile.

Un type valeur a deux représentations distinctes dans le Common Language Infrastructure (CLI) :

  • Une forme « brute » utilisée lorsqu’un type valeur est incorporé dans un autre objet ou sur la pile.

  • Une forme « boxed » où les données du type valeur sont encapsulées (converties) dans un objet afin qu’il peut exister une entité indépendante.

La box instruction convertit le type valeur « brut » (unboxed) en une référence d’objet (type O). Cela s’effectue en créant un nouvel objet et copie des données à partir du type de valeur dans l’objet nouvellement alloué. valTypeToken est un jeton de métadonnées indiquant le type du type valeur dans la pile.

OutOfMemoryException est levée si la mémoire est insuffisante pour satisfaire la requête.

TypeLoadException est levée si la classe est introuvable. Cette exception est généralement détectée lorsque le langage MSIL (Microsoft Intermediate Language) est converti en code natif, plutôt que lors de l’exécution.

Les éléments suivants Emit surcharge de méthode peut utiliser le box opcode :

  • ILGenerator.Emit (OpCode, Type)

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.1
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: