.NET Framework 工具
圖形用戶端、資訊清單產生和編輯工具 (MageUI.exe)
MageUI.exe 所支援的功能與命令列工具 Mage.exe 相同，不過 MageUI.exe 具有 Windows Form 架構的使用者介面 (UI)。您可以利用這個工具來建立、編輯和簽章部署與應用程式資訊清單。
可用的功能表和工具列項目如下。
部署資訊清單
建立新的部署資訊清單。
應用程式資訊清單
建立新的應用程式資訊清單。
開啟
開啟現有的部署資訊清單、應用程式資訊清單或信任授權以進行編輯。
儲存
將目前使用者輸入焦點所在的文件儲存至磁碟中。
另存新檔
將檔案儲存至磁碟，可讓您提供新的檔案名稱和 (或) 位置。
全部儲存
將 MageUI.exe 中目前開啟的所有檔案所進行的變更儲存起來。
關閉
關閉開啟的檔案。
如果檔案在關閉之前做過修改，MageUI.exe 會提示您使用公開金鑰 (Public Key)、金鑰組 (Key Pair) 或預存的憑證，重新替這個檔案簽章。
結束
結束 MageUI.exe。
剪下
從應用程式中移除目前選取的文字，然後移至系統剪貼簿。
複製
將目前選取的文字複製至系統剪貼簿。
貼上
將文字從系統剪貼簿貼到目前現用的文字項目上。
刪除
刪除清單中目前選取的項目，例如 [部署資訊清單] 索引標籤上的信任授權。如需詳細資訊，請參閱 MageUI.exe 部署資訊清單索引標籤。
喜好設定
開啟 [喜好設定] 對話方塊。如需詳細資訊，請參閱下一節。
全部關閉
關閉 MageUI.exe 中目前開啟的所有檔案。如果有一或多個檔案需要進行儲存，MageUI.exe 會提示您儲存這些檔案。MageUI.exe 也會提示您選取簽章密鑰，以處理每個未簽章或變更過的檔案。
內容
開啟這一份說明文件。
關於
顯示 MageUI.exe 的版本和著作權資訊。
喜好設定對話方塊
[喜好設定] 對話方塊包含下列項目。
儲存時簽章
每當您儲存修改內容時，都會提示您替檔案簽章。
使用預設簽章密鑰
使用 [金鑰檔] 文字方塊中所輸入的金鑰，替所有檔案簽章。在選取 [儲存時簽章] 的情況下，如果選取這個選項，則當您儲存檔案時，原本會出現的簽章提示就不會出現。請使用 [金鑰檔] 文字方塊旁的 [瀏覽] 按鈕來選取金鑰檔。
簽章選項對話方塊
首次儲存資訊清單或信任授權，或是變更資訊清單或信任授權時，[簽章選項] 對話方塊會隨即出現。但是您必須在 [喜好設定] 對話方塊中選取 [儲存時簽章資訊清單] 選項，這個對話方塊才會出現。
這個對話方塊包含下列項目。
使用憑證檔簽章
使用儲存於檔案系統的數位憑證替資訊清單簽章。
檔案
提供一個區域，以便於輸入表示憑證的 .pfx 檔案路徑。
...
開啟 [選擇檔案] 對話方塊，選取現有的 .pfx 檔。
新增
產生新的 .pfx，這個檔案無法透過憑證授權單位 (CA) 進行驗證。如需簽章 ClickOnce 部署時所用之憑證類型的詳細資訊，請參閱受信任的應用程式部署概觀。
密碼
提供區域以便輸入密碼，此密碼可以在以這個憑證簽章時使用。如果不適用，此項目可以保持空白。
使用預存的憑證簽章
以可選取清單的形式，顯示儲存在電腦憑證存放區內的數位憑證。
時間戳記 URI
顯示時間戳記服務的統一資源定位器 (URL)，ClickOnce 會使用此 URL 來驗證憑證的時效。如需時間戳記的詳細資訊，請參閱 ClickOnce 部署和 Authenticode。
索引標籤和面板描述
使用 MageUI.exe 開啟文件時，文件會出現在自己的索引標籤頁內。每個索引標籤都包含一組屬性面板。面板中含有一組文件資料的子集。如需編輯每一類文件時可用之 UI 項目的詳細資訊，請參閱 MageUI.exe 部署資訊清單索引標籤和 MageUI.exe 應用程式資訊清單索引標籤。
請參閱
工作
逐步解說：手動部署 ClickOnce 應用程式
參考
資訊清單產生和編輯工具 (Mage.exe)
概念
ClickOnce 部署概觀
3/20/2009
3/18/2009
Ildasm.exe 教學
文章&圖示請參照http://msdn.microsoft.com/zh-tw/library/aa309387(VS.71).aspx
這個教學課程提供了 .NET Framework SDK 中所附之 MSIL 反組譯工具 (Ildasm.exe) 的簡介。Ildasm.exe 工具可以剖析任何 .NET Framework .exe 或 .dll 組件 (Assembly)，並且以人們可閱讀的 (Human-Readable) 格式顯示資訊。Ildasm.exe 不只會顯示 Microsoft Intermediate Language (MSIL) 程式碼，也會顯示包括介面在內的命名空間 (Namespace) 和型別。您可以使用 Ildasm.exe 來檢查 .NET Framework 的原生組件 (例如 Mscorlib.dll)，以及其他人提供的或是您自行建立的 .NET Framework 組件。大部分 .NET Framework 開發人員都會認為 Ildasm.exe 是不可或缺的工具。
對於這個教學課程，請使用隨附在 SDK 中之 WordCount 範例的 Visual C# 版本。您也可以使用 Visual Basic 版本，但是這兩種語言所產生的 MSIL 將會不同，畫面影像也不盡相同。WordCount 位於\Samples\Applications\WordCount\ 目錄中。若要建置 (Build) 和執行範例，請依照 Readme.htm 檔案中所列的指示進行。這個教學課程會使用 Ildasm.exe 來檢查 WordCount.exe 組件。
若要開始，請建置 WordCount 範例，並使用下列命令列將它載入 Ildasm.exe 中：
ildasm WordCount.exe
這樣便會使 Ildasm.exe 的視窗顯示出來，如下圖所示。
Ildasm.exe 視窗中的樹狀結構會顯示 WordCount.exe 內部包含的組件資訊清單資訊，以及四個全域類別型別：App、ArgParser、WordCountArgParser 和 WordCounter。
按兩下樹狀結構中的任何型別，即可看見型別的詳細資訊。在下圖中，已將 WordCounter 類別型別展開。
在上圖中，您可以看見所有的 WordCounter 成員。下列表格將說明每一個圖形符號所代表的意義。
符號 意義
詳細資訊
命名空間
類別
介面
數值類別
列舉型別
方法
靜態方法
欄位
靜態欄位
事件
屬性
資訊清單或類別資訊項目
按兩下 .class public auto ansi beforefieldinit 項目會顯示下列資訊：
在上圖中，您可以清楚地看出來，WordCounter 型別是從 System.Object 型別衍生而來。
WordCounter 型別還包含另外一個型別，名稱為 WordOccurrence。您可以將 WordOccurrence 型別展開，即可看見它的成員，如下圖所示。
從樹狀結構中可以看出來，WordOccurrence 實作了 System.IComparable 介面，更明確地講，就是 CompareTo 方法。不過，在後續的說明中，我們將略過 WordOccurrence 型別，而將焦點集中在 WordCounter 型別上。
您可以看到 WordCounter 型別含有五個 private 欄位：totalBytes、totalChars、totalLines、totalWords 和 wordCounter。前四個欄位是 int64 型別的執行個體 (Instance)，而 wordCounter 欄位則是 System.Collections.SortedList 型別的參考。
在這些欄位之後，您可以看見方法。第一個方法 .ctor 是建構函式 (Constructor)。這個特殊的型別只有一個建構函式，但是其他型別則可以有多個建構函式，每一個的簽名碼 (Signature) 都不同。WordCounter 建構函式的傳回型別 (Return Type) 為 void (和所有建構函式一樣)，而且不接受參數。如果按兩下建構函式方法，會出現新的視窗，它會顯示方法中所包含的 MSIL 程式碼，如下圖所示。
MSIL 程式碼實際上很容易閱讀和了解 (如需所有的詳細資訊，請參閱位於\Tool Developers Guide\Docs 資料夾 Partition III CIL.doc 檔案中的 CIL Instruction Set Specification)。在最接近頂端的地方，您可以看見這個建構函式需要 50 個位元組的 MSIL 程式碼。從這個數字並不能判斷出 JIT 編譯器將會發出多少機器碼，因為它的大小是根據主機 CPU 和用來產生程式碼的編譯器而定。
Common Language Runtime 為堆疊架構。因此，若要執行任何作業，MSIL 程式碼會先將運算元推入虛擬堆疊中，然後執行運算子。運算子會將運算元從堆疊中抓取出來、執行所需的作業，然後將結果放回堆疊上。不論任何時候，這個方法推入虛擬堆疊上的運算元都不能超過八個。您只要查看出現在 MSIL 程式碼前面的 .maxstack 屬性，就可以辨識出這個數目。
現在，請檢查前面幾個 MSIL 指令，如下列四行：
IL_0000: ldarg.0 ; Load the object's 'this' pointer on the stack
IL_0001: ldc.i4.0 ; Load the constant 4-byte value of 0 on the stack
IL_0002: conv.i8 ; Convert the 4-byte 0 to an 8-byte 0
IL_0003: stfld int64 WordCounter::totalLines
位於 IL_0000 的指令會將傳遞至方法的第一個參數載入到虛擬堆疊上，而且一定會將物件記憶體的位址傳遞給每一個執行個體方法 (Instance Method)。這個引數稱為 Argument Zero，而且不會明確顯示在方法的簽名碼中。因此，即使 .ctor 方法看起來像是接收了零個引數，實際上是接收了一個引數。接著，位於 IL_0000 的指令會將這個物件的指標載入到虛擬堆疊上。
位於 IL_0001 的指令會將 4 位元組的零值常數載入到虛擬堆疊上。
位於 IL_0002 的指令會取得堆疊頂端的數值 (4 位元組的零)，並將它轉換成 8 位元組的零，如此便會將 8 位元組的零放到堆疊的頂端。
這時，堆疊含有兩個運算元：8 位元組的零和指向這個物件的指標。位於 IL_0003 的指令會使用這兩個運算元，將堆疊頂端的數值 (8 位元組的零) 儲存到堆疊上所辨識物件的 totalLines 欄位中。
totalChars、totalBytes 和 totalWords 欄位會重複相同的 MSIL 指令序列 (Sequence)。
wordCounter 欄位的初始化是從位於 IL_0020 的指令開始，如以下所示：
IL_0020: ldarg.0
IL_0021: newobj instance void [mscorlib]System.Collections.SortedList::.ctor()
IL_0026: stfld class [mscorlib]System.Collections.SortedList WordCounter::wordCounter
位於 IL_0020 的指令會將 WordCounter 的 this 指標推入虛擬堆疊上。newobj 指令不會使用這個運算元，但是位於 IL_0026 的 stfld 指令將會使用。
位於 IL_0021 的指令會告知 Runtime 建立新的 System.Collections.SortedList 物件，並且不使用任何引數呼叫它的建構函式。當 newobj 傳回時，SortedList 物件的位址是在堆疊上。這時候，位於 IL_0026 的 stfld 指令會將 SortedList 物件的指標儲存到 WordCounter 物件的 wordCounter 欄位中。
在所有 WordCounter 物件的欄位都完成初始化之後，位於 IL_002b 的指令會將 this 指標推到虛擬堆疊上，然後 IL_002b 會呼叫基底型別 (Base Type) (System.Object) 中的建構函式。
當然，位於 IL_0031 的最後一個指令是傳回指令，會使 WordCounter 建構函式傳回到建立函式的程式碼中。建構函式必須傳回 void，在建構函式傳回之前才不會將任何物件放入堆疊上。
下面是另外一個範例。請按兩下 GetWordsByOccurranceEnumerator 方法，即可看見它的 MSIL 程式碼，如下圖所示。
您可以看見，這個方法的程式碼大小為 69 個位元組，而且這個方法在虛擬堆疊上需要有四個位置。此外，這個方法還有三個區域變數：一個為 System.Collection.SortedList 型別，另外兩個為 System.Collections.IDictionaryEnumerator 型別。請注意，除非組件與 /debug 選項相容，否則不會將原始程式碼中提到的變數名稱發出到 MSIL 程式碼中。如果沒有使用 /debug，會分別使用 V_0、V_1 和 V_2 等變數名稱來取代 sl、de 和 CS$00000003$00000000。
當這個方法開始執行時，第一件事就是執行 newobj 指令，這個指令會建立新的 System.Collections.SortedList 物件，並呼叫這個物件的預設建構函式。當 newobj 傳回時，所建立物件的位址是在虛擬堆疊上。stloc.0 指令 (位於 IL_0005) 會將這個值儲存在區域變數 0 或 sl (不含 /debug 的 V_0) (屬於 System.Collections.SortedList 型別) 中。
位於 IL_0006 和 IL_0007 的指令會將 WordCounter 物件的 this 指標 (在傳遞至方法的 Argument Zero 中) 載入到堆疊上，並呼叫 GetWordsAlphabeticallyEnumerator 方法。當 call 指令傳回時，列舉值的位址是在堆疊上。stloc.1 指令 (位於 IL_000c) 會將這個位址儲存在區域變數 1 或 de (不含 /debug 的 V_1)，這個變數屬於 System.Collections.IDictionaryEnumerator 型別。
位於 IL_000d 的 br.s 指令會造成 while 陳述式的 IL 測試條件無條件分支。這個 IL 測試條件從位於 IL_0032 的指令開始。在 IL_0032 位址中，會將 de (或 V_1) (IDictionaryEnumerator) 的位址推到堆疊上，然後在 IL_0033 位址呼叫它的 MoveNext 方法。如果 MoveNext 傳回 True，表示有要列舉的項目，而且 brtrue.s 指令會跳到位於 IL_000f 的指令。
在位於 IL_000f 和 IL_0010 的指令中，會將 sl (或 V_0) 和 de (或 V_1) 中的物件位址推到堆疊上。然後，呼叫 IdictionaryEnumerator 物件的 get_Value 屬性方法，以取得目前項目的項目數目。這個數目是儲存在 System.Int32 中的 32 位元值。程式碼會將 Int32 物件轉換成 int 數值型別 (Value Type)。將參考型別 (Reference Type) 轉換成數值型別需要位於 IL_0016 的 unbox 指令。當 unbox 傳回時，Unboxed 數值的位址是在堆疊上。ldind.i4 指令 (位於 IL_001b) 會將 4 位元組的數值 (這個數值會指向目前在堆疊上的位址) 載入到堆疊上。換句話說，Unboxed 4 位元組整數是放在堆疊上。
在位於 IL_001c 的指令中，會將 sl (或 V_1) 的數值 (IDictionaryEnumerator 的位址) 推到堆疊上，並呼叫它的 get_Key 屬性方法。當 get_Key 傳回時，System.Object 的位址是在堆疊上。程式碼知道字典中包含字串，因此編譯器會使用位於 IL_0022 的 castclass 指令，將這個 Object 轉換成 String。
以下幾個新的指令 (從 IL_0027 到 IL_002d) 會建立新的 WordOccurrence 物件，然後將物件的位址傳遞至 SortedLists 物件的 Add 方法。
在位於 IL_0032 的指令中，會再評估一次 while 陳述式的測試條件。如果 MoveNext 傳回 True，迴圈 (Loop) 會執行另一個循環。但是，如果 MoveNext 傳回 False，迴圈會停止執行，並在位於 IL_003a 的指令結束。位於 IL_003a 到 IL_0040 的指令會呼叫 SortLists 物件的 GetEnumerator 方法。傳回的值為 System.Collections.IDictionaryEnumerator，它是被留在堆疊上而成為 GetWordsByOccurrenceEnumerator 傳回值。
這個教學課程提供了 .NET Framework SDK 中所附之 MSIL 反組譯工具 (Ildasm.exe) 的簡介。Ildasm.exe 工具可以剖析任何 .NET Framework .exe 或 .dll 組件 (Assembly)，並且以人們可閱讀的 (Human-Readable) 格式顯示資訊。Ildasm.exe 不只會顯示 Microsoft Intermediate Language (MSIL) 程式碼，也會顯示包括介面在內的命名空間 (Namespace) 和型別。您可以使用 Ildasm.exe 來檢查 .NET Framework 的原生組件 (例如 Mscorlib.dll)，以及其他人提供的或是您自行建立的 .NET Framework 組件。大部分 .NET Framework 開發人員都會認為 Ildasm.exe 是不可或缺的工具。
對於這個教學課程，請使用隨附在 SDK 中之 WordCount 範例的 Visual C# 版本。您也可以使用 Visual Basic 版本，但是這兩種語言所產生的 MSIL 將會不同，畫面影像也不盡相同。WordCount 位於
若要開始，請建置 WordCount 範例，並使用下列命令列將它載入 Ildasm.exe 中：
ildasm WordCount.exe
這樣便會使 Ildasm.exe 的視窗顯示出來，如下圖所示。
Ildasm.exe 視窗中的樹狀結構會顯示 WordCount.exe 內部包含的組件資訊清單資訊，以及四個全域類別型別：App、ArgParser、WordCountArgParser 和 WordCounter。
按兩下樹狀結構中的任何型別，即可看見型別的詳細資訊。在下圖中，已將 WordCounter 類別型別展開。
在上圖中，您可以看見所有的 WordCounter 成員。下列表格將說明每一個圖形符號所代表的意義。
符號 意義
詳細資訊
命名空間
類別
介面
數值類別
列舉型別
方法
靜態方法
欄位
靜態欄位
事件
屬性
資訊清單或類別資訊項目
按兩下 .class public auto ansi beforefieldinit 項目會顯示下列資訊：
在上圖中，您可以清楚地看出來，WordCounter 型別是從 System.Object 型別衍生而來。
WordCounter 型別還包含另外一個型別，名稱為 WordOccurrence。您可以將 WordOccurrence 型別展開，即可看見它的成員，如下圖所示。
從樹狀結構中可以看出來，WordOccurrence 實作了 System.IComparable 介面，更明確地講，就是 CompareTo 方法。不過，在後續的說明中，我們將略過 WordOccurrence 型別，而將焦點集中在 WordCounter 型別上。
您可以看到 WordCounter 型別含有五個 private 欄位：totalBytes、totalChars、totalLines、totalWords 和 wordCounter。前四個欄位是 int64 型別的執行個體 (Instance)，而 wordCounter 欄位則是 System.Collections.SortedList 型別的參考。
在這些欄位之後，您可以看見方法。第一個方法 .ctor 是建構函式 (Constructor)。這個特殊的型別只有一個建構函式，但是其他型別則可以有多個建構函式，每一個的簽名碼 (Signature) 都不同。WordCounter 建構函式的傳回型別 (Return Type) 為 void (和所有建構函式一樣)，而且不接受參數。如果按兩下建構函式方法，會出現新的視窗，它會顯示方法中所包含的 MSIL 程式碼，如下圖所示。
MSIL 程式碼實際上很容易閱讀和了解 (如需所有的詳細資訊，請參閱位於
Common Language Runtime 為堆疊架構。因此，若要執行任何作業，MSIL 程式碼會先將運算元推入虛擬堆疊中，然後執行運算子。運算子會將運算元從堆疊中抓取出來、執行所需的作業，然後將結果放回堆疊上。不論任何時候，這個方法推入虛擬堆疊上的運算元都不能超過八個。您只要查看出現在 MSIL 程式碼前面的 .maxstack 屬性，就可以辨識出這個數目。
現在，請檢查前面幾個 MSIL 指令，如下列四行：
IL_0000: ldarg.0 ; Load the object's 'this' pointer on the stack
IL_0001: ldc.i4.0 ; Load the constant 4-byte value of 0 on the stack
IL_0002: conv.i8 ; Convert the 4-byte 0 to an 8-byte 0
IL_0003: stfld int64 WordCounter::totalLines
位於 IL_0000 的指令會將傳遞至方法的第一個參數載入到虛擬堆疊上，而且一定會將物件記憶體的位址傳遞給每一個執行個體方法 (Instance Method)。這個引數稱為 Argument Zero，而且不會明確顯示在方法的簽名碼中。因此，即使 .ctor 方法看起來像是接收了零個引數，實際上是接收了一個引數。接著，位於 IL_0000 的指令會將這個物件的指標載入到虛擬堆疊上。
位於 IL_0001 的指令會將 4 位元組的零值常數載入到虛擬堆疊上。
位於 IL_0002 的指令會取得堆疊頂端的數值 (4 位元組的零)，並將它轉換成 8 位元組的零，如此便會將 8 位元組的零放到堆疊的頂端。
這時，堆疊含有兩個運算元：8 位元組的零和指向這個物件的指標。位於 IL_0003 的指令會使用這兩個運算元，將堆疊頂端的數值 (8 位元組的零) 儲存到堆疊上所辨識物件的 totalLines 欄位中。
totalChars、totalBytes 和 totalWords 欄位會重複相同的 MSIL 指令序列 (Sequence)。
wordCounter 欄位的初始化是從位於 IL_0020 的指令開始，如以下所示：
IL_0020: ldarg.0
IL_0021: newobj instance void [mscorlib]System.Collections.SortedList::.ctor()
IL_0026: stfld class [mscorlib]System.Collections.SortedList WordCounter::wordCounter
位於 IL_0020 的指令會將 WordCounter 的 this 指標推入虛擬堆疊上。newobj 指令不會使用這個運算元，但是位於 IL_0026 的 stfld 指令將會使用。
位於 IL_0021 的指令會告知 Runtime 建立新的 System.Collections.SortedList 物件，並且不使用任何引數呼叫它的建構函式。當 newobj 傳回時，SortedList 物件的位址是在堆疊上。這時候，位於 IL_0026 的 stfld 指令會將 SortedList 物件的指標儲存到 WordCounter 物件的 wordCounter 欄位中。
在所有 WordCounter 物件的欄位都完成初始化之後，位於 IL_002b 的指令會將 this 指標推到虛擬堆疊上，然後 IL_002b 會呼叫基底型別 (Base Type) (System.Object) 中的建構函式。
當然，位於 IL_0031 的最後一個指令是傳回指令，會使 WordCounter 建構函式傳回到建立函式的程式碼中。建構函式必須傳回 void，在建構函式傳回之前才不會將任何物件放入堆疊上。
下面是另外一個範例。請按兩下 GetWordsByOccurranceEnumerator 方法，即可看見它的 MSIL 程式碼，如下圖所示。
您可以看見，這個方法的程式碼大小為 69 個位元組，而且這個方法在虛擬堆疊上需要有四個位置。此外，這個方法還有三個區域變數：一個為 System.Collection.SortedList 型別，另外兩個為 System.Collections.IDictionaryEnumerator 型別。請注意，除非組件與 /debug 選項相容，否則不會將原始程式碼中提到的變數名稱發出到 MSIL 程式碼中。如果沒有使用 /debug，會分別使用 V_0、V_1 和 V_2 等變數名稱來取代 sl、de 和 CS$00000003$00000000。
當這個方法開始執行時，第一件事就是執行 newobj 指令，這個指令會建立新的 System.Collections.SortedList 物件，並呼叫這個物件的預設建構函式。當 newobj 傳回時，所建立物件的位址是在虛擬堆疊上。stloc.0 指令 (位於 IL_0005) 會將這個值儲存在區域變數 0 或 sl (不含 /debug 的 V_0) (屬於 System.Collections.SortedList 型別) 中。
位於 IL_0006 和 IL_0007 的指令會將 WordCounter 物件的 this 指標 (在傳遞至方法的 Argument Zero 中) 載入到堆疊上，並呼叫 GetWordsAlphabeticallyEnumerator 方法。當 call 指令傳回時，列舉值的位址是在堆疊上。stloc.1 指令 (位於 IL_000c) 會將這個位址儲存在區域變數 1 或 de (不含 /debug 的 V_1)，這個變數屬於 System.Collections.IDictionaryEnumerator 型別。
位於 IL_000d 的 br.s 指令會造成 while 陳述式的 IL 測試條件無條件分支。這個 IL 測試條件從位於 IL_0032 的指令開始。在 IL_0032 位址中，會將 de (或 V_1) (IDictionaryEnumerator) 的位址推到堆疊上，然後在 IL_0033 位址呼叫它的 MoveNext 方法。如果 MoveNext 傳回 True，表示有要列舉的項目，而且 brtrue.s 指令會跳到位於 IL_000f 的指令。
在位於 IL_000f 和 IL_0010 的指令中，會將 sl (或 V_0) 和 de (或 V_1) 中的物件位址推到堆疊上。然後，呼叫 IdictionaryEnumerator 物件的 get_Value 屬性方法，以取得目前項目的項目數目。這個數目是儲存在 System.Int32 中的 32 位元值。程式碼會將 Int32 物件轉換成 int 數值型別 (Value Type)。將參考型別 (Reference Type) 轉換成數值型別需要位於 IL_0016 的 unbox 指令。當 unbox 傳回時，Unboxed 數值的位址是在堆疊上。ldind.i4 指令 (位於 IL_001b) 會將 4 位元組的數值 (這個數值會指向目前在堆疊上的位址) 載入到堆疊上。換句話說，Unboxed 4 位元組整數是放在堆疊上。
在位於 IL_001c 的指令中，會將 sl (或 V_1) 的數值 (IDictionaryEnumerator 的位址) 推到堆疊上，並呼叫它的 get_Key 屬性方法。當 get_Key 傳回時，System.Object 的位址是在堆疊上。程式碼知道字典中包含字串，因此編譯器會使用位於 IL_0022 的 castclass 指令，將這個 Object 轉換成 String。
以下幾個新的指令 (從 IL_0027 到 IL_002d) 會建立新的 WordOccurrence 物件，然後將物件的位址傳遞至 SortedLists 物件的 Add 方法。
在位於 IL_0032 的指令中，會再評估一次 while 陳述式的測試條件。如果 MoveNext 傳回 True，迴圈 (Loop) 會執行另一個循環。但是，如果 MoveNext 傳回 False，迴圈會停止執行，並在位於 IL_003a 的指令結束。位於 IL_003a 到 IL_0040 的指令會呼叫 SortLists 物件的 GetEnumerator 方法。傳回的值為 System.Collections.IDictionaryEnumerator，它是被留在堆疊上而成為 GetWordsByOccurrenceEnumerator 傳回值。
MSIL 反組譯工具 (Ildasm.exe)
.NET Framework 工具
MSIL 反組譯工具 (Ildasm.exe)
MSIL 反組譯工具是 MSIL 組譯工具 (Ilasm.exe) 的附屬工具。Ildasm.exe 使用包含 Microsoft Intermediate Language (MSIL) 程式碼之可移植的執行檔 (PE)，並建立可以做為 Ilasm.exe 之輸入檔的文字檔。
ildasm [options] [PEfilename] [options]
參數
下列選項可用於 .exe、.dll、.obj 和 .lib 檔。
選項 描述
/output= filename
建立具有指定 filename 的輸出檔，而非在圖形化使用者介面中顯示結果。
/rtf
以 Rich Text Format (.rtf 檔案) 產生輸出。使用 /text 選項時無效。
.NET Framework 2.0 版的新功能。
/text
顯示結果到主控台 (Console) 視窗，而非在圖形化使用者介面中顯示或做為輸出檔。
/html
以 HTML 格式產生輸出。僅使用 /output 選項時才有效。
.NET Framework 2.0 版的新功能。
/?
顯示工具的命令語法和選項。
下列額外的選項可用於 .exe 和 .dll 檔。
選項 描述
/bytes
以十六進位格式顯示實際位元組做為指令註解。
/caverbal
以動詞化格式產生自訂屬性 BLOB (二進位大型物件)。預設為二進位格式。
.NET Framework 2.0 版的新功能。
/linenum
包含原始程式行的參考。
/nobar
隱藏反組譯碼進度指示器快顯視窗 (Pop-Up Window)。
/noca
隱藏自訂屬性的輸出。
.NET Framework 2.0 版的新功能。
/pubonly
僅反組譯公用型別和成員。等同於 /visibility:PUB。
/quoteallnames
在單引號內包含所有的名稱。
/raweh
以未經處理格式顯示例外處理 (Exception Handling) 子句。
/source
顯示原始程式行做為註解。
/tokens
顯示類別和成員的中繼資料語彙基元 (Token)。
/visibility: vis [+vis ...]
以指定的可視性僅反組譯型別或成員。下列都是 vis 的有效值：
PUB — Public
PRI — Private
FAM — Family
ASM — Assembly
FAA — Family 和 Assembly
FOA — Family 或 Assembly
PSC — Private Scope
如需這些可視性修飾詞 (Modifier) 的定義，請參閱 MethodAttributes 和 TypeAttributes。
下列選項對 .exe 和 .dll 檔有效，僅適用於檔案或主控台輸出。
選項 描述
/all
指定 /header、/bytes、/stats、/classlist 和 /tokens 選項的組合。
注意事項
在 .NET Framework 1.0 和 1.1 版中，指定 /header、/bytes 和 /tokens 選項的組合。
/classlist
包括在模組中定義的類別清單。
.NET Framework 2.0 版的新功能。
/forward
使用 forward 類別宣告。
.NET Framework 2.0 版的新功能。
/header
在輸出中包含檔頭資訊。
/item: class[::method [(sig)]]
根據提供的引數反組譯下列項目：
反組譯指定的 class。
反組譯指定之 class 的 method。
以指定的簽名 sig 反組譯 class 的 method。以傳回型別 (Return Type) 以及所需的參數指定簽名。例如，returntype (param1, param2,..paramn)。
/noil
隱藏 MSIL 組譯碼輸出。
/stats
包括映像的統計資料。
.NET Framework 2.0 版的新功能。
/typelist
產生型別完整清單，以保留來回之間的型別順序。
.NET Framework 2.0 版的新功能。
/unicode
輸出使用 Unicode 編碼方式。
/utf8
輸出使用 UTF-8 編碼方式。ANSI 是預設值。
下列選項對 .exe、.dll、.obj 和 .lib 檔有效，僅適用於檔案或主控台輸出。
選項 描述
/metadata[=specifier]
顯示中繼資料 (Metadata)，其中 specifier 是：
MDHEADER — 顯示中繼資料的標頭資訊和大小。
HEX — 使用十六進位和文字顯示資訊。
CSV — 顯示記錄計數和堆積大小。
UNREX — 顯示無法解析的外部符號。
SCHEMA — 顯示中繼資料的標頭和結構描述資訊。
RAW — 顯示原始中繼資料的表格。
HEAPS — 顯示原始的堆積。
VALIDATE — 驗證中繼資料的一致性。
您可以多次指定 /metadata，每次使用不同的 specifier 值。
.NET Framework 2.0 版的新功能。
下列選項只對適用於檔案或主控台輸出的 .lib 檔有效。
選項 描述
/objectfile=filename
在指定的程式庫中顯示單一物件檔案的中繼資料。
.NET Framework 2.0 版的新功能。
注意事項
所有 Ildasm.exe 的選項都不區分大小寫，並且是以前三個字母識別。例如，/quo 就相當於 /quoteallnames。指定引數的選項可以接受冒號 (:) 或等號 (=) 做為選項與引數之間的分隔符號。例如，/output:filename 等同於 /output=filename。
備註
Ildasm.exe 只在磁碟上的 PE 檔上作業。它無法在安裝於全域組件快取中的檔案上作業。
Ildasm.exe 所產生的文字檔可以被用來做為 MSIL 組譯工具 (Ilasm.exe) 的輸入。這非常有用，例如在不支援所有執行階段中繼資料屬性的程式語言中編譯程式碼時。在編譯程式碼並透過 Ildasm.exe 執行其輸出之後，可以手動編輯產生的 MSIL 文字檔來加入遺漏的屬性。然後可以透過 MSIL 組譯工具執行這個文字檔來產生最後的可執行檔。
注意事項
目前您無法將這項技術用於包含內嵌機器碼的 PE 檔 (例如，由 Visual C++ 所產生的 PE 檔)。
您可以使用 MSIL 反組譯工具中的預設 GUI，來檢視在階層式樹狀檢視中任何現有 PE 檔的中繼資料和反組譯碼。若要使用 GUI，請在命令列輸入 ildasm，但不提供 PEfilename 引數或任何選項。您可以從 [檔案] 功能表，巡覽至要載入到 Ildasm.exe 的 PE 檔。若要儲存為所選的 PE 所顯示的中繼資料和反組譯程式碼，請從 [檔案] 功能表中選取 [傾印] 命令。若只要儲存階層式樹狀檢視，請從 [檔案] 功能表中選取 [傾印樹狀檢視] 命令。如需載入檔案到 Ildasm.exe 和解譯輸出的詳細指引，請參閱＜Ildasm.exe 教學課程＞，位於與 .NET Framework SDK 一起推出的 Samples 資料夾中。
如果您提供 Ildasm.exe 和包含內嵌資源的 PEfilename 引數，這個工具就會產生多個輸出檔案：包含 MSIL 程式碼的文字檔，以及對每個內嵌的 Managed 資源，使用來自中繼資料 (Metadata) 的資源名稱所產生的 .resources 檔。如果 Unmanaged 資源是內嵌於 PEfilename，.res 檔是使用由 /output 選項輸出的 MSIL 的指定檔名所產生。
注意事項
Ildasm.exe 僅會顯示 .obj 和 .lib 輸入檔的中繼資料描述。這些檔案類型的 MSIL 程式碼是不被反組譯的。
您可以在 .exe 或 .dll 檔上執行 Ildasm.exe 來判斷這個檔案是否為 Managed。如果這個檔案不是 Managed，工具便會顯示訊息，說明這個檔案沒有有效的 Common Language Runtime 標頭而且無法反組譯。如果這個檔案是 Managed，工具就會順利執行。
範例
下列命令會使得 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 含有內嵌 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 和 System.String 的傳回型別反組譯 MyMethod 方法。
複製程式碼
ildasm /item:"MyClass::MyMethod(void(int32,class System.String))" MyFile.exe /text 請參閱
參考
.NET Framework 工具
MSIL 組譯工具 (Ilasm.exe)
SDK 命令提示字元
概念
編譯為 MSIL
MSIL 反組譯工具 (Ildasm.exe)
MSIL 反組譯工具是 MSIL 組譯工具 (Ilasm.exe) 的附屬工具。Ildasm.exe 使用包含 Microsoft Intermediate Language (MSIL) 程式碼之可移植的執行檔 (PE)，並建立可以做為 Ilasm.exe 之輸入檔的文字檔。
ildasm [options] [PEfilename] [options]
參數
下列選項可用於 .exe、.dll、.obj 和 .lib 檔。
選項 描述
/output= filename
建立具有指定 filename 的輸出檔，而非在圖形化使用者介面中顯示結果。
/rtf
以 Rich Text Format (.rtf 檔案) 產生輸出。使用 /text 選項時無效。
.NET Framework 2.0 版的新功能。
/text
顯示結果到主控台 (Console) 視窗，而非在圖形化使用者介面中顯示或做為輸出檔。
/html
以 HTML 格式產生輸出。僅使用 /output 選項時才有效。
.NET Framework 2.0 版的新功能。
/?
顯示工具的命令語法和選項。
下列額外的選項可用於 .exe 和 .dll 檔。
選項 描述
/bytes
以十六進位格式顯示實際位元組做為指令註解。
/caverbal
以動詞化格式產生自訂屬性 BLOB (二進位大型物件)。預設為二進位格式。
.NET Framework 2.0 版的新功能。
/linenum
包含原始程式行的參考。
/nobar
隱藏反組譯碼進度指示器快顯視窗 (Pop-Up Window)。
/noca
隱藏自訂屬性的輸出。
.NET Framework 2.0 版的新功能。
/pubonly
僅反組譯公用型別和成員。等同於 /visibility:PUB。
/quoteallnames
在單引號內包含所有的名稱。
/raweh
以未經處理格式顯示例外處理 (Exception Handling) 子句。
/source
顯示原始程式行做為註解。
/tokens
顯示類別和成員的中繼資料語彙基元 (Token)。
/visibility: vis [+vis ...]
以指定的可視性僅反組譯型別或成員。下列都是 vis 的有效值：
PUB — Public
PRI — Private
FAM — Family
ASM — Assembly
FAA — Family 和 Assembly
FOA — Family 或 Assembly
PSC — Private Scope
如需這些可視性修飾詞 (Modifier) 的定義，請參閱 MethodAttributes 和 TypeAttributes。
下列選項對 .exe 和 .dll 檔有效，僅適用於檔案或主控台輸出。
選項 描述
/all
指定 /header、/bytes、/stats、/classlist 和 /tokens 選項的組合。
注意事項
在 .NET Framework 1.0 和 1.1 版中，指定 /header、/bytes 和 /tokens 選項的組合。
/classlist
包括在模組中定義的類別清單。
.NET Framework 2.0 版的新功能。
/forward
使用 forward 類別宣告。
.NET Framework 2.0 版的新功能。
/header
在輸出中包含檔頭資訊。
/item: class[::method [(sig)]]
根據提供的引數反組譯下列項目：
反組譯指定的 class。
反組譯指定之 class 的 method。
以指定的簽名 sig 反組譯 class 的 method。以傳回型別 (Return Type) 以及所需的參數指定簽名。例如，returntype (param1, param2,..paramn)。
/noil
隱藏 MSIL 組譯碼輸出。
/stats
包括映像的統計資料。
.NET Framework 2.0 版的新功能。
/typelist
產生型別完整清單，以保留來回之間的型別順序。
.NET Framework 2.0 版的新功能。
/unicode
輸出使用 Unicode 編碼方式。
/utf8
輸出使用 UTF-8 編碼方式。ANSI 是預設值。
下列選項對 .exe、.dll、.obj 和 .lib 檔有效，僅適用於檔案或主控台輸出。
選項 描述
/metadata[=specifier]
顯示中繼資料 (Metadata)，其中 specifier 是：
MDHEADER — 顯示中繼資料的標頭資訊和大小。
HEX — 使用十六進位和文字顯示資訊。
CSV — 顯示記錄計數和堆積大小。
UNREX — 顯示無法解析的外部符號。
SCHEMA — 顯示中繼資料的標頭和結構描述資訊。
RAW — 顯示原始中繼資料的表格。
HEAPS — 顯示原始的堆積。
VALIDATE — 驗證中繼資料的一致性。
您可以多次指定 /metadata，每次使用不同的 specifier 值。
.NET Framework 2.0 版的新功能。
下列選項只對適用於檔案或主控台輸出的 .lib 檔有效。
選項 描述
/objectfile=filename
在指定的程式庫中顯示單一物件檔案的中繼資料。
.NET Framework 2.0 版的新功能。
注意事項
所有 Ildasm.exe 的選項都不區分大小寫，並且是以前三個字母識別。例如，/quo 就相當於 /quoteallnames。指定引數的選項可以接受冒號 (:) 或等號 (=) 做為選項與引數之間的分隔符號。例如，/output:filename 等同於 /output=filename。
備註
Ildasm.exe 只在磁碟上的 PE 檔上作業。它無法在安裝於全域組件快取中的檔案上作業。
Ildasm.exe 所產生的文字檔可以被用來做為 MSIL 組譯工具 (Ilasm.exe) 的輸入。這非常有用，例如在不支援所有執行階段中繼資料屬性的程式語言中編譯程式碼時。在編譯程式碼並透過 Ildasm.exe 執行其輸出之後，可以手動編輯產生的 MSIL 文字檔來加入遺漏的屬性。然後可以透過 MSIL 組譯工具執行這個文字檔來產生最後的可執行檔。
注意事項
目前您無法將這項技術用於包含內嵌機器碼的 PE 檔 (例如，由 Visual C++ 所產生的 PE 檔)。
您可以使用 MSIL 反組譯工具中的預設 GUI，來檢視在階層式樹狀檢視中任何現有 PE 檔的中繼資料和反組譯碼。若要使用 GUI，請在命令列輸入 ildasm，但不提供 PEfilename 引數或任何選項。您可以從 [檔案] 功能表，巡覽至要載入到 Ildasm.exe 的 PE 檔。若要儲存為所選的 PE 所顯示的中繼資料和反組譯程式碼，請從 [檔案] 功能表中選取 [傾印] 命令。若只要儲存階層式樹狀檢視，請從 [檔案] 功能表中選取 [傾印樹狀檢視] 命令。如需載入檔案到 Ildasm.exe 和解譯輸出的詳細指引，請參閱＜Ildasm.exe 教學課程＞，位於與 .NET Framework SDK 一起推出的 Samples 資料夾中。
如果您提供 Ildasm.exe 和包含內嵌資源的 PEfilename 引數，這個工具就會產生多個輸出檔案：包含 MSIL 程式碼的文字檔，以及對每個內嵌的 Managed 資源，使用來自中繼資料 (Metadata) 的資源名稱所產生的 .resources 檔。如果 Unmanaged 資源是內嵌於 PEfilename，.res 檔是使用由 /output 選項輸出的 MSIL 的指定檔名所產生。
注意事項
Ildasm.exe 僅會顯示 .obj 和 .lib 輸入檔的中繼資料描述。這些檔案類型的 MSIL 程式碼是不被反組譯的。
您可以在 .exe 或 .dll 檔上執行 Ildasm.exe 來判斷這個檔案是否為 Managed。如果這個檔案不是 Managed，工具便會顯示訊息，說明這個檔案沒有有效的 Common Language Runtime 標頭而且無法反組譯。如果這個檔案是 Managed，工具就會順利執行。
範例
下列命令會使得 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 含有內嵌 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 和 System.String 的傳回型別反組譯 MyMethod 方法。
複製程式碼
ildasm /item:"MyClass::MyMethod(void(int32,class System.String))" MyFile.exe /text 請參閱
參考
.NET Framework 工具
MSIL 組譯工具 (Ilasm.exe)
SDK 命令提示字元
概念
編譯為 MSIL
訂閱：
文章 (Atom)