OpCodes.Ldelem_Ref フィールド

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

OpCodes.Ldelem_Ref フィールド

指定した配列インデックスのオブジェクト参照を格納している要素を O 型 (オブジェクト参照) として評価スタックの一番上に読み込みます。

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

Visual Basic (宣言)

Public Shared ReadOnly Ldelem_Ref
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Ldelem_Ref

C#

public static readonly OpCode Ldelem_Ref

C++

public:
static initonly OpCode Ldelem_Ref

J#

public static final OpCode Ldelem_Ref

JScript

public static final var
 Ldelem_Ref : OpCode

解説

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

形式	アセンブリ形式	説明
9A	ldelem.ref	index にあるオブジェクト参照を持つ要素を O 型としてスタックの一番上に読み込みます。

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

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

2. インデックス値 index がスタックにプッシュされます。

3. index と array がスタックからポップされます。array 内の index の位置に格納された値が検索されます。

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

ldelem.ref 命令は、インデックス番号が 0 から始まる 1 次元配列 array 内のインデックス index (natural int 型) を持つ要素の値を読み込み、スタックの一番上に配置します。配列はオブジェクトであるため、O 型の値によって表されます。

ldelem.ref の戻り値は O 型 (オブジェクト参照) です。

array が null 参照である場合は、NullReferenceException がスローされます。

array が必要な型の要素を保持していない場合は、ArrayTypeMismatchException がスローされます。

index が負の値である場合、または array の上限を超える場合は、IndexOutOfRangeException がスローされます。

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

• ILGenerator.Emit(OpCode)

プラットフォーム

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 名前空間