OpCodes.Castclass Champ

  • Référence

Définition

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

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;
[System.Runtime.InteropServices.ComVisible(true)]
public static readonly System.Reflection.Emit.OpCode Castclass;
 staticval mutable Castclass : System.Reflection.Emit.OpCode
[<System.Runtime.InteropServices.ComVisible(true)>]
 staticval mutable Castclass : System.Reflection.Emit.OpCode
Public Shared ReadOnly Castclass As OpCode

Valeur de champ

OpCode
Attributs
ComVisibleAttribute

Remarques

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

Format Format d’assembly Description
74 < T > castclass class Convertit un objet en un nouvel objet de type class.

Le comportement de transition de 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é comme spécifié class.

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

L’instruction castclass tente de convertir la référence d’objet (type O) au-dessus 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 en haut de la pile n’implémente pas la nouvelle classe (en supposant que la nouvelle classe est une interface) et qu’elle n’est pas une classe dérivée de la nouvelle classe, une InvalidCastException classe 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 converti 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 :

S’applique à