OpCodes.Unbox フィールド

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

OpCodes.Unbox フィールド

値型のボックス化変換された形式をボックス化が解除された形式に変換します。

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

Visual Basic (宣言)

Public Shared ReadOnly Unbox
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Unbox

C#

public static readonly OpCode Unbox

C++

public:
static initonly OpCode Unbox

J#

public static final OpCode Unbox

JScript

public static final var
 Unbox : OpCode

解説

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

形式	アセンブリ形式	説明
79 < T >	unbox valType	obj から値型データ (ボックス化変換後の形式) を抽出します。

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

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

2. オブジェクト参照がスタックからポップされ、ボックス化が解除されて値型ポインタになります。

3. 値型ポインタがスタックにプッシュされます。

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

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

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

unbox 命令は、値型のボックス化変換後の形式であるオブジェクト参照 (O 型) をボックス化が解除された形式である値型ポインタ (マネージ ポインタ、& 型) に変換します。提供された値型 (valType) は、ボックス化変換されたオブジェクト内に格納されている値型の型を示すメタデータ トークンです。

オブジェクトで使用する値型のコピーを作成する必要がある Box とは異なり、unbox はオブジェクトから値型をコピーする必要はありません。通常は、ボックス化変換されたオブジェクト内の既存の値型のアドレスを単純に計算します。

オブジェクトが valType としてボックス化変換されていな場合は、InvalidCastException がスローされます。

オブジェクト参照が null 参照の場合は、NullReferenceException がスローされます。

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

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