OpCodes.Box フィールド

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

OpCodes.Box フィールド

値型をオブジェクト参照 (O 型) に変換します。

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

Visual Basic (宣言)

Public Shared ReadOnly Box
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Box

C#

public static readonly OpCode Box

C++

public:
static initonly OpCode Box

J#

public static final OpCode Box

JScript

public static final var
 Box : OpCode

解説

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

形式	アセンブリ形式	説明
8C < T >	box valTypeToken	値型 (valTypeToken で指定した型) を true オブジェクト参照に変換します。

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

1. 値型がスタックにプッシュされます。

2. スタックから値型がポップされます。box 演算が実行されます。

3. 結果として得られる "ボックス化された" 値型がスタックにプッシュされます。

値型には共通言語基盤 (CLI) 内に次の 2 つの別個の形式があります。

• "生" の形式。値型が他のオブジェクト内またはスタックに埋め込まれている場合に使用されます。

• "ボックス化された" 形式。値型の中のデータは、独立したエンティティとして存在できるように、オブジェクトにラップ (ボックス化) されます。

box 命令は、"生の" (ボックス化が解除された) 値型をオブジェクト参照 (O 型) に変換します。このためには、新しいオブジェクトを作成し、値型から新しく割り当てられたオブジェクトにデータをコピーします。valTypeToken は、スタックの値型を示すメタデータ トークンです。

要求を満たすにはメモリが不足している場合は、OutOfMemoryException がスローされます。

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

box オペコードを使用できる 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 名前空間