OpCodes.Stelem_Ref フィールド

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

OpCodes.Stelem_Ref フィールド

指定のインデックス位置にある配列要素をオブジェクト参照値 (O 型) に置き換えます。

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

Visual Basic (宣言)

Public Shared ReadOnly Stelem_Ref
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Stelem_Ref

C#

public static readonly OpCode Stelem_Ref

C++

public:
static initonly OpCode Stelem_Ref

J#

public static final OpCode Stelem_Ref

JScript

public static final var
 Stelem_Ref : OpCode

解説

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

形式	アセンブリ形式	説明
A2	stelem.ref	提供されたインデックス位置にある配列要素をスタックの ref 値 (O 型) に置き換えます。

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

1. 配列へのオブジェクト参照である array がスタックにプッシュされます。

2. array 内の要素への有効なインデックスがスタックにプッシュされます。

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

4. 値、インデックス、および配列参照がスタックからポップされます。値は、指定のインデックスの配列要素に格納されます。

stelem.ref 命令は、1 次元配列 array 内の提供されたインデックス位置にある要素の値をスタックにプッシュされた ref (O 型) 値に置き換えます。

配列はオブジェクトであるため、O 型の値によって表されます。インデックスは natural int 型です。

stelem.ref は、配列要素に値を割り当てる前に、提供された値を array 要素型に暗黙的にキャストします。このキャストは、検査されたコードであっても、失敗する場合があります。したがって、stelem.ref 命令が InvalidCastException をスローすることがあります。インデックス番号が 0 以外で始まる 1 次元配列および多次元配列の場合は、Array クラスが SetValue メソッドを提供します。

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

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

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

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