MSIL 逆アセンブラ (Ildasm.exe)

更新 : 2007 年 11 月

MSIL 逆アセンブラは MSIL アセンブラ (Ilasm.exe) と対をなすツールです。Ildasm.exe は、Microsoft Intermediate Language (MSIL) コードを含む、ポータブル実行可能 (PE) ファイルを使用して、Ilasm.exe に対する入力として適したテキスト ファイルを作成します。

ildasm [options] [PEfilename] [options]

パラメータ

.exe、.dll、.obj、.lib の各ファイルについて、次のオプションを使用できます。

.exe ファイルと .dll ファイルについては、次のオプションも利用できます。

次のオプションは、.exe ファイルおよび .dll ファイルをファイル出力またはコンソール出力する場合にだけ有効です。

オプション	説明
/all	/header、/bytes、/stats、/classlist、および /tokens の各オプションの組み合わせを指定します。 メモ : .NET Framework Versions 1.0 と 1.1 では、/header、/bytes、/tokens の各オプションの組み合わせを指定します。
/classlist	モジュールで定義されているクラスの一覧を含めます。 .NET Framework Version 2.0 で新たに追加されました。
/forward	事前のクラス宣言を使用します。 .NET Framework Version 2.0 で新たに追加されました。
/header	出力にファイル ヘッダー情報を組み込みます。
/item:class[::member[(sig]]	指定した引数に応じて、次の要素を逆アセンブルします。 指定した class を逆アセンブルします。 指定した class の member を逆アセンブルします。 指定したシグネチャ sig を持つ class の memberを逆アセンブルします。sig の書式は次のとおりです。 [instance] returnType(parameterType1, parameterType2, …, parameterTypeN) メモ   .NET Framework Version 1.0 および 1.1 では、(sig) のように、sig の後に閉じかっこを付ける必要があります。Version 2.0 では、閉じかっこを省略して (sig とする必要があります。
/noil	MSIL アセンブリ コードの出力を中止します。
/stats	イメージの統計情報を含めます。 .NET Framework Version 2.0 で新たに追加されました。
/typelist	ラウンド トリップの型の順序を保存するために、型の完全な一覧を生成します。 .NET Framework Version 2.0 で新たに追加されました。
/unicode	出力に Unicode エンコードを使用します。
/utf8	出力に UTF-8 エンコードを使用します。既定値は ANSI です。

次のオプションは、.exe、.dll、.obj、.lib の各ファイルをファイル出力またはコンソール出力する場合にだけ有効です。

次のオプションは、.lib ファイルをファイル出力またはコンソール出力する場合にだけ有効です。

メモ :
Ildasm.exe に関するすべてのオプションでは大文字と小文字が区別されず、先頭の 3 文字で認識されます。たとえば、/quo は /quoteallnames と等価です。引数を伴うオプションの場合は、オプションと引数の間に区切り記号としてコロン (:) または等号 (=) を挿入できます。たとえば、/output:filename は /output=filename と等価です。

解説

Ildasm.exe はディスク上のファイルについてだけ動作します。グローバル アセンブリ キャッシュ内にインストールされたファイルについては動作しません。

Ildasm.exe で生成されるテキスト ファイルを MSIL アセンブラ (Ilasm.exe) に対する入力として使用できます。これは、必ずしもランタイム メタデータ属性のすべてをサポートしないプログラミング言語で記述されたコードをコンパイルするときなどに便利です。コードをコンパイルし、その出力を Ildasm.exe で実行した後、生成された MSIL テキスト ファイルを手作業で編集して足りない属性を追加できます。このテキスト ファイルを MSIL アセンブラで実行すると、最終的な実行可能ファイルを生成できます。

メモ :
現時点では、埋め込みのネイティブ コード (たとえば Visual C++ で生成された PE ファイル) を含む PE ファイルについては、この手法を使用できません。

MSIL 逆アセンブラで既定の GUI を使用すると、既存のどの PE ファイルのメタデータおよび逆アセンブルしたコードでも、階層ツリー ビューで表示できます。GUI を使用するには、引数 PEfilename またはその他のオプションを指定せずに、コマンド行で「ildasm」と入力します。[ファイル] メニューで、Ildasm.exe に読み込む PE ファイルまで移動できます。選択した PE ファイルについて表示された、メタデータおよび逆アセンブルしたコードを保存するには、[ファイル] メニューの [ダンプ] をクリックします。階層ツリー ビューだけを保存するには、[ファイル] メニューの [ツリービューをダンプ] をクリックします。Ildasm.exe へのファイルの読み込み方法、および出力の解釈の詳細については、Windows Software Development Kit (SDK) に用意されている Samples フォルダ内の Ildasm.exe のチュートリアルを参照してください。

Ildasm.exe に対して、埋め込みリソースを含む引数 PEfilename を指定した場合は、複数の出力ファイルが生成されます。生成されるファイルは、MSIL コードを含む 1 つのテキスト ファイルと、埋め込みマネージ リソースごとにリソース名を使用してメタデータから生成した .resources ファイルです。アンマネージ リソースが PEfilename の中に埋め込まれている場合は、MSIL 出力に対して /output オプションで指定されたファイル名を使用して、.res ファイルが生成されます。

メモ :
Ildasm.exe では、入力ファイルの .obj と .lib についてはメタデータの説明だけが表示されます。これらの種類のファイルの場合、MSIL コードは逆アセンブルされません。

Ildasm.exe を .exe ファイルまたは .dll ファイルに対して実行し、ファイルが管理されているかどうかを確認できます。ファイルが管理されていない場合は、そのファイルに有効な共通言語ランタイム ヘッダーがないため、逆アセンブルできないことを示すメッセージが表示されます。ファイルが管理されている場合は、処理が正常に行われます。

例

PE ファイル MyHello.exe のメタデータと逆アセンブルしたコードを、Ildasm.exe の既定の GUI で表示するコマンドを次に示します。

ildasm myHello.exe

ファイル MyFile.exe を逆アセンブルし、その結果の MSIL アセンブラ テキストをファイル MyFile.il に格納するコマンドを次に示します。

ildasm MyFile.exe /output:MyFile.il

ファイル MyFile.exe を逆アセンブルし、その結果の MSIL アセンブラ テキストをコンソール ウィンドウに表示するコマンドを次に示します。

ildasm MyFile.exe /text

MyApp.exe に埋め込みのマネージ リソースとアンマネージ リソースが含まれる場合に次のコマンドを実行すると、4 つのファイル、MyApp.il、MyApp.res、Icons.resources, 、および Message.resources が生成されます。

ildasm MyApp.exe /output:MyApp.il

MyFile.exe 内のクラス MyClass に属するメソッド MyMethod を逆アセンブルし、その出力をコンソール ウィンドウに表示するコマンドを次に示します。

ildasm /item:MyClass::MyMethod MyFile.exe /text

上の例では、異なるシグネチャを持つ MyMethod という名前のメソッドが複数存在する可能性があります。戻り値の型 void、およびパラメータの型 int32 と string を指定してインスタンス メソッド MyMethod を逆アセンブルするコマンドを次に示します。

ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text

メモ :
.NET Framework Version 1.0 および 1.1 では、メソッド名の後にある左かっことシグネチャの後にある右かっこの数が一致するように MyMethod(instance void(int32)) とする必要があります。.NET Framework Version 2.0 では、閉じかっこを省略して MyMethod(instance void(int32) とする必要があります。

static メソッド (Visual Basic の Shared メソッド) を取得するには、キーワード instance を省略します。int32 や string のようなプリミティブ型でないクラス型には名前空間を含め、キーワード class を前に付ける必要があります。外部の型には、角かっこで囲んだライブラリ名を前に付ける必要があります。AppDomain 型の 1 つのパラメータと AppDomain 型の戻り値を持つ、MyMethod という名前の静的メソッドを逆アセンブルするコマンドを次に示します。

ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text

入れ子になった型は、クラスを前に付けてスラッシュで区切る必要があります。たとえば、MyNamespace.MyClass クラスに NestedClass という名前の入れ子になったクラスが含まれている場合は、class MyNamespace.MyClass/NestedClass のように指定します。

参照

概念

MSIL へのコンパイル

参照

.NET Framework ツール

MSIL アセンブラ (Ilasm.exe)

SDK のコマンド プロンプト