OpCodes.Newobj フィールド

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

OpCodes.Newobj フィールド

新しいオブジェクトまたは値型の新しいインスタンスを作成し、オブジェクト参照 (O 型) を評価スタックにプッシュします。

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

Visual Basic (宣言)

Public Shared ReadOnly Newobj
 As OpCode

Visual Basic (使用法)

Dim value As OpCode

value = OpCodes.Newobj

C#

public static readonly OpCode Newobj

C++

public:
static initonly OpCode Newobj

J#

public static final OpCode Newobj

JScript

public static final var
 Newobj : OpCode

解説

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

形式	アセンブリ形式	説明
73 < T >	newobj ctor	初期化されていないオブジェクトまたは値型を割り当て、コンストラクタ メソッド ctor を呼び出します。

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

1. 引数 arg1 ～ argn が、順番にスタックにプッシュされます。

2. オブジェクトを作成するために、引数 argn ～ arg1 がスタックからポップされ、ctor に渡されます。

3. 新しいオブジェクトへの参照が、スタックにプッシュされます。

newobj 命令は、新しいオブジェクトまたは値型の新しいインスタンスを作成します。Ctor は、呼び出すコンストラクタの名前、クラス、およびシグネチャを示すメタデータ トークン (コンストラクタとしてマークしておく必要がある methodref または methoddef) です。

newobj 命令は、ctor に関連付けられたクラスの新しいインスタンスを割り当て、必要に応じて、新しいインスタンスのすべてのフィールドを適切な型の 0 に初期化するか、または null 参照にします。次に、指定の引数と新しく作成されたインスタンスを使用して、コンストラクタ ctor を呼び出します。コンストラクタが呼び出されると、初期化されたオブジェクト参照 (O 型) がスタックにプッシュされます。

コンストラクタの視点から見ると、初期化されていないオブジェクトは引数 0 であり、newobj に渡されたその他の引数が順番に続きます。

インデックス番号が 0 から始まるすべての 1 次元配列は、newobj ではなく、Newarr を使用して作成されます。これに対し、その他のすべての配列 (多次元配列またはインデックス番号が 0 以外から始まる 1 次元配列) は、newobj を使用して作成されます。

通常、値型は、newobj を使用して作成されることはありません。値型は、通常、newarr (インデックス番号が 0 から始まる、1 次元配列の場合) を使用して引数またはローカル変数として、あるいはオブジェクトのフィールドとして割り当てられます。割り当てられると、値型は Initobj を使用して初期化されます。ただし、newobj 命令を使用して、値型の新しいインスタンスをスタック上に作成し、それを引数として渡したり、ローカルに格納したりできます。

要求を満たすにはメモリが不足している場合は、OutOfMemoryException がスローされます。

指定した名前、クラス、およびシグネチャを持つコンストラクタ メソッド ctor が見つからなかった場合は、MissingMethodException がスローされます。これは、通常、実行時ではなく、MSIL (Microsoft Intermediate Language) 命令がネイティブ コードに変換されるときに検出されます。

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

• ILGenerator.Emit(OpCode, ConstructorInfo)

プラットフォーム

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