Ildasm.exe (IL 反組譯工具)

IL 反組譯工具是 IL 組譯工具 (Ilasm.exe) 的附屬工具。 Ildasm.exe 採用包含中繼語言 (IL) 程式碼的可攜式執行檔 (PE)，並建立適合用作 Ilasm.exe 輸入的文字檔。

此工具會自動與 Visual Studio 一起安裝。 若要執行此工具，請使用 Visual Studio 開發人員命令提示字元或 Visual Studio 開發人員 PowerShell。

在命令提示字元中，請輸入下列項目：

語法

ildasm [options] [PEfilename] [options]

參數

下列選項可用於 .exe、.dll、.obj、.lib 和 .winmd 檔案。

下列其他選項可用於 .exe、.dll 和 .winmd 檔案。

下列選項只對檔案或主控台輸出的 .exe、.dll 和 .winmd 檔案有效。

下列選項只對檔案或主控台輸出的 .exe、.dll、.obj、.lib 和 .winmd 檔案有效。

下列選項只對檔案或主控台輸出的 .lib 檔案有效。

備註

Ildasm.exe 只在磁碟上的 PE 檔上作業。 它無法在安裝於全域組件快取中的檔案上作業。

Ildasm.exe 所產生的文字檔可以用作 IL 組譯工具 (Ilasm.exe) 的輸入。 這非常有用，例如在不支援所有執行階段中繼資料屬性的程式語言中編譯程式碼時。 編譯完程式碼並透過 Ildasm.exe 執行其輸出後，可以手動編輯產生的 IL 文字檔來新增遺漏的屬性。 然後可以透過 IL 組譯工具執行這個文字檔來產生最後的可執行檔。

您可以使用 IL 反組譯工具中的預設 GUI，檢視階層樹狀檢視中任何現有 PE 檔的中繼資料和反組譯碼。 若要使用 GUI，請在命令列鍵入 ildasm，但不提供 PEfilename 引數或任何選項。 您可以從 [檔案] 功能表巡覽至要載入 Ildasm.exe 中的 PE 檔。 若要儲存針對所選取 PE 顯示的中繼資料和反組譯程式碼，請選取 [檔案] 功能表中的 [傾印] 命令。 若只要儲存階層樹狀檢閱，請從 [檔案] 功能表中選取 [傾印樹狀檢視] 命令。 如需將檔案載入 Ildasm.exe 及解譯輸出的詳細指南，請參閱位於 Windows SDK 隨附 [Samples] 資料夾中的 Ildasm.exe 教學課程。

如果您將包含內嵌資源的 PEfilename 引數提供給 Ildasm.exe，這個工具就會產生多個輸出檔案：包含 IL 程式碼的文字檔；每個內嵌的 Managed 資源還會各有一個使用來自中繼資料的資源名稱所產生的 .resources 檔案。 如果 Unmanaged 資源內嵌於 PEfilename，/output 選項就會使用為 IL 指定的檔案名稱來產生 .res 檔案。

您可以對 .exe 或 .dll 檔案執行 Ildasm.exe 來判斷該檔案是否為 Managed。 如果檔案不是 Managed，工具便會顯示一則訊息，說明該檔案沒有有效的通用語言執行平台標頭而且無法進行反組譯。 如果檔案是 Managed，工具就會成功執行。

版本資訊

從 .NET Framework 4.5 開始， Ildasm.exe藉由顯示原始二進位內容來處理無法辨識的封送處理 BLOB (二進位大型物件) 。 例如，下列程式碼將示範如何顯示 C# 程式所產生的封送處理 BLOB：

public void Test([MarshalAs((short)70)] int test) { }

// IL from Ildasm.exe output
.method public hidebysig instance void Test(int32  marshal({ 46 }) test) cil managed

從 .NET Framework 4.5 開始， Ildasm.exe會顯示套用至介面實作的屬性，如下列來自Ildasm.exe輸出的摘錄所示：

.class public auto ansi beforefieldinit MyClass
  extends [mscorlib]System.Object
  implements IMyInterface
  {
    .interfaceimpl type IMyInterface
    .custom instance void
      [mscorlib]System.Diagnostics.DebuggerNonUserCodeAttribute::.ctor() = ( 01 00 00 00 )
      …

範例

下列命令會讓 PE 檔 MyHello.exe 的中繼資料和反組譯程式碼顯示於 Ildasm.exe 的預設 GUI 中。

ildasm myHello.exe

下列命令會反組譯 MyFile.exe 檔案，並將產生的 IL 組譯工具文字儲存到 MyFile.il 檔案中。

ildasm MyFile.exe /output:MyFile.il

下列命令會反組譯 MyFile.exe 檔案，並在主控台視窗中顯示產生的 IL 組譯工具文字。

ildasm MyFile.exe /text

如果檔案 MyApp.exe 包含內嵌的 Managed 和 Unmanaged 資源，則下列命令會產生四個檔案：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

若要擷取 static 方法 (在 Visual Basic 中為 Shared 方法)，請省略關鍵字 instance。 不是 int32 和 string 等基本類型 (Primitive Type) 的類別類型，都必須包含命名空間，而且前面必須加上關鍵字 class。 外部類型的前面必須加上以方括號括住的程式庫名稱。 下列命令會反組譯名為 MyMethod 的靜態方法，該靜態方法具有一個 AppDomain 類型的參數，而且傳回類型為 AppDomain。

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

巢狀類型的前面必須加上它的包含類別，並以正斜線分隔。 例如，如果 MyNamespace.MyClass 類別包含名為 NestedClass 的巢狀類別，則該巢狀類別的識別方式如下：class MyNamespace.MyClass/NestedClass。

另請參閱

• 工具
• Ilasm.exe (IL 組譯工具)
• Managed 執行程序
• 開發人員命令列殼層