OpCodes.Castclass フィールド

.NET Framework クラス ライブラリ リファレンス

OpCodes.Castclass フィールド

指定したクラスへの参照により渡されたオブジェクトをキャストしようとします。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Shared ReadOnly Castclass
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Castclass

C#

[ComVisibleAttribute(true)] 
public static readonly OpCode Castclass

C++

[ComVisibleAttribute(true)] 
public:
static initonly OpCode Castclass

J#

/** @attribute ComVisibleAttribute(true) */ 
public static final OpCode Castclass

JScript

ComVisibleAttribute(true) 
public static final var
 Castclass : OpCode

解説

命令の 16 進数の形式、MSIL (Microsoft Intermediate Language) アセンブリ形式、および簡単な説明の一覧を次の表に示します。

形式	アセンブリ形式	説明
74 < T >	castclass class	class 型の新しいオブジェクトにオブジェクトをキャストします。

スタックの遷移動作を順番に示すと、次のようになります。

1. オブジェクト参照がスタックにプッシュされます。

2. スタックからオブジェクト参照がポップされます。参照されるオブジェクトは、指定した class としてキャストされます。

3. 成功すると、新しいオブジェクト参照がスタックにプッシュされます。

castclass 命令は、指定したクラスにスタックの一番上のオブジェクト参照 (O 型) をキャストしようとします。新しいクラスは、目的のクラスを示すメタデータ トークンによって指定されます。スタックの一番上にあるオブジェクトのクラスが、新しいクラスを実装しておらず (新しいクラスがインターフェイスであることを前提とする)、新しいクラスの派生クラスでもない場合は、InvalidCastException がスローされます。オブジェクト参照が null 参照である場合は、castclass が成功し、新しいオブジェクトを null 参照として返します。

obj をクラスにキャストできない場合は、InvalidCastException がスローされます。

クラスが見つからない場合は、TypeLoadException がスローされます。これは、通常、実行時ではなく、MSIL (Microsoft Intermediate Language) 命令がネイティブ コードに変換されるときに検出されます。

castclass オペコードを使用できる Emit メソッド オーバーロードを次に示します。

• ILGenerator.Emit(OpCode, Type)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OpCodes クラス
OpCodes メンバ
System.Reflection.Emit 名前空間