OpCodes.Castclass Champ

Définition

Espace de noms:

System.Reflection.Emit

Assembly:

System.Reflection.Primitives.dll

Source:

OpCodes.cs

Tente d'effectuer un cast d'un objet passé par référence en classe spécifiée.

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

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

 staticval mutable Castclass : System.Reflection.Emit.OpCode

Public Shared ReadOnly Castclass 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
74 <T>	castclass class	Caste un objet en un nouvel objet de type class.

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

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

2. La référence d’objet est extraite de la pile ; l’objet référencé est casté classen tant que spécifié.

3. En cas de réussite, une nouvelle référence d’objet est envoyée à la pile.

L’instruction castclass tente de caster la référence d’objet (type O) au sommet de la pile en une classe spécifiée. La nouvelle classe est spécifiée par un jeton de métadonnées indiquant la classe souhaitée. Si la classe de l’objet situé en haut de la pile n’implémente pas la nouvelle classe (en supposant que la nouvelle classe est une interface) et n’est pas une classe dérivée de la nouvelle classe, une InvalidCastException est levée. Si la référence d’objet est une référence null, castclass réussit et retourne le nouvel objet en tant que référence null.

InvalidCastException est levée si obj ne peut pas être casté en classe.

TypeLoadException est levée si la classe est introuvable. Cela est généralement détecté lorsqu’une instruction MSIL (Microsoft Intermediate Language) est convertie en code natif plutôt qu’au moment de l’exécution.

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

• ILGenerator.Emit(OpCode, Type)