OpCodes.Ldelema フィールド

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

OpCodes.Ldelema フィールド

指定した配列インデックスにある配列要素のアドレスを & 型 (マネージ ポインタ) として評価スタックの一番上に読み込みます。

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

Visual Basic (宣言)

Public Shared ReadOnly Ldelema
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Ldelema

C#

public static readonly OpCode Ldelema

C++

public:
static initonly OpCode Ldelema

J#

public static final OpCode Ldelema

JScript

public static final var
 Ldelema : OpCode

解説

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

形式	アセンブリ形式	説明
8F < T >	ldelema class	index にある配列要素のアドレスを & 型 (マネージ ポインタ) として評価スタックの一番上に読み込みます。

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

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

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

3. index と array がスタックからポップされます。array の index の位置に格納されているアドレスが検索されます。

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

ldelema を使用してオブジェクト (class 型) の配列の特定のインデックスにあるオブジェクトのアドレスを取得します。ldelema 命令は、インデックス番号が 0 から始まる 1 次元配列 array 内のインデックス index (natural int 型) の値のアドレスを読み込み、スタックの一番上に配置します。配列はオブジェクトであるため、O 型の値によって表されます。値は、命令と共に渡された class 型である必要があります。

ldelema の戻り値は、マネージ ポインタ (& 型) です。

4 バイト未満の整数値は、評価スタックに読み込まれるときに、natural int ではなく、int32 に拡張されます。

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

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

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

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