OpCodes.Stloc フィールド

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

OpCodes.Stloc フィールド

評価スタックの一番上から現在の値をポップし、指定したインデックスのローカル変数リストに格納します。

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

Visual Basic (宣言)

Public Shared ReadOnly Stloc
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Stloc

C#

public static readonly OpCode Stloc

C++

public:
static initonly OpCode Stloc

J#

public static final OpCode Stloc

JScript

public static final var
 Stloc : OpCode

解説

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

形式	アセンブリ形式	説明
FE 0E < unsigned int16 >	stloc index	スタックから値をポップし、ローカル変数 index に格納します。

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

1. 値がスタックからポップされ、ローカル変数 index に配置されます。

stloc 命令は、評価スタックの一番上の値をポップし、ローカル変数番号 index にその値を移動します。ローカル変数の番号は 0 から始まります。値の型は、現在のメソッドのローカル シグネチャで指定されているローカル変数の型と一致している必要があります。

4 バイト長より小さい整数値を保持しているローカルに格納すると、スタックからローカル変数に移動するときに値が切り詰められます。浮動小数点値は、ネイティブ サイズ (F 型) から引数に関連付けられたサイズに丸められます。

正しい MSIL (Microsoft Intermediate Language) 命令では、index が有効なローカル インデックスであることが要求されます。stloc 命令の場合、index は 0 ～ 65,534 の範囲内である必要があります。65,535 は無効です。65,535 を無効とすることには、実際上の理由があります。実装では、2 バイト整数を使用して、ローカルのインデックスおよび指定したメソッドのローカルの合計数の両方を追跡する場合があるためです。インデックス 65,535 を有効にすると、指定したメソッドのローカル数を追跡するために、より広い範囲の整数を使用する必要があります。

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

• ILGenerator.Emit(OpCode, LocalBuilder)

• ILGenerator.Emit(OpCode, short)

プラットフォーム

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