scsc.exe 帶來的樂趣 
 C# 編譯器選項(xiàng)概覽 
 配置環(huán)境變量 
 命令行基礎(chǔ)知識(shí) 
 用于指定輸入和控制輸出的選項(xiàng) 
 編譯 .NET 代碼庫 
 使用 C# 響應(yīng)文件 
 使用 /reference 引用外部程序集 
 理解 C# 2.0 引用別名 
 使用 /addmodule 生成多文件程序集 
 創(chuàng)建 Windows 窗體應(yīng)用程序 
 通過 csc.exe 使用資源 
 使用 /define 定義預(yù)處理器符號(hào) 
 csc.exe 的以調(diào)試為中心的選項(xiàng) 
 雜項(xiàng) 
 小結(jié) 

scsc.exe 帶來的樂趣

幾乎沒有人會(huì)否認(rèn)集成開發(fā)環(huán)境 (IDE)（例如，Visual Studio 2005 和 Visual C# Express 2005）所提供的能使編程工作變得相當(dāng)簡單的諸多功能。但是，實(shí)際上 IDE 自己通常不能提供對(duì)基礎(chǔ)編譯器的所有方面的訪問。例如，Visual Studio 2005 不支持生成多文件程序集。

此外，了解在命令行編譯代碼的過程，對(duì)于具有以下特征的用戶可能有用：

如果您屬于上面所述的這些用戶，那么就忠實(shí)于自己的選擇并繼續(xù)讀下去吧。

C# 編譯器 csc.exe 提供了大量用于對(duì)創(chuàng)建 .NET 程序集的方式進(jìn)行控制的選項(xiàng)。站在一個(gè)較高層次來看，命令行選項(xiàng)屬于下列八個(gè)類別之一（表 1）。

表 1. csc.exe 提供的標(biāo)記的類別

注 1.0 和 1.1 版本的 C# 編譯器中存在的 /incremental 標(biāo)志現(xiàn)在已過時(shí)。

在閱讀本文的過程中，您將了解每個(gè)編譯器類別中存在的核心 標(biāo)志（最重要的詞是核心）。對(duì)于大多數(shù)開發(fā)方案，可以安全地忽略 C# 編譯器的很多高級(jí)選項(xiàng)。如果您需要有關(guān)本文未予討論的 csc.exe 功能的詳細(xì)信息，請(qǐng)盡管放心，您可以參閱 Microsoft Visual Studio 2005 文檔幫助系統(tǒng)（只須從“Search”選項(xiàng)卡中搜索“csc.exe”并深入查閱）。

注 MSDN 文檔也會(huì)對(duì)您也很所幫助，因?yàn)樗枋隽巳绾卧?Visual Studio（如果可用）內(nèi)部設(shè)置 csc.exe 的特定選項(xiàng)。

返回頁首

配置環(huán)境變量

在使用任何 .NET SDK 命令行工具（包括 C# 編譯器）之前，需要配置開發(fā)計(jì)算機(jī)以識(shí)別它們的存在。最簡單的方法是使用 Start | All Programs | Visual Studio 2005 | Visual Studio Tools 菜單選項(xiàng)，啟動(dòng)預(yù)配置的 Visual Studio 命令提示。這一特定的控制臺(tái)能夠自動(dòng)初始化必要的環(huán)境變量，而無須您執(zhí)行任何操作。（Visual Studio .NET 2003 用戶需要啟動(dòng)他們各自的命令提示）。

注 如果您沒有 Visual Studio，但是已經(jīng)安裝了 .NET Framework SDK，則可以從 Start | All Programs |Microsoft .NET Framework SDK 2.0 菜單選項(xiàng)啟動(dòng)預(yù)配置的命令提示。

如果您希望從任意的 命令提示使用 .NET 命令行工具，則需要手動(dòng)更新計(jì)算機(jī)的 Path 變量。做法是，請(qǐng)右鍵單擊桌面上的 My Computer 圖標(biāo)并選擇 Properties 菜單選項(xiàng)。從出現(xiàn)的對(duì)話框中，單擊位于 Advanced 選項(xiàng)卡下面的 Environment Variables 按鈕。從出現(xiàn)的對(duì)話框中，在 System 變量列表框中的當(dāng)前 Path 變量的結(jié)尾添加以下目錄清單（請(qǐng)注意，必須用分號(hào)分隔各個(gè)條目）：

C:\Windows\Microsoft.NET\Framework\v2.0.40607C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin

注 上面的列表指向我的當(dāng)前 .NET 2.0 測試版的路徑。您的路徑可能因 Visual Studio 和/或 .NET SDK 的安裝和版本的不同而略有不同，因此請(qǐng)確保執(zhí)行完整性檢查。

在更新 Path 變量之后，請(qǐng)立即關(guān)閉所有對(duì)話框和當(dāng)前打開的任何 Console 窗口，以便提交設(shè)置。您現(xiàn)在應(yīng)當(dāng)能夠從任何命令提示執(zhí)行 csc.exe 和其他 .NET 工具了。要進(jìn)行測試，請(qǐng)輸入以下命令：

csc -?ildasm -?

如果您看到有大量信息顯示出來，那么您就可以繼續(xù)了。

返回頁首

命令行基礎(chǔ)知識(shí)

已經(jīng)能夠熟練地在命令行工作的用戶在使用 csc.exe 時(shí)不會(huì)有任何問題，因而可以跳到下一節(jié)。但是，如果您使用命令行的次數(shù)很有限，那么請(qǐng)讓我說明一些基本的詳細(xì)信息，以便進(jìn)行必要的準(zhǔn)備。

首先，可以使用反斜杠或單個(gè)短劃線指定 csc.exe 的選項(xiàng)。其次，在 / 或 - 以及隨后的標(biāo)志之間具有額外的空格是非法 的。因此，“-help”是完全正確，而“- help”就行不通了。為了加以說明，讓我們使用 help 標(biāo)志檢查完整的命令行選項(xiàng)集：

csc –helpcsc /help

如果一切正常，則您應(yīng)當(dāng)看到所有可能的標(biāo)志，如圖 1 所示。

圖 1. 幫助標(biāo)志

很多選項(xiàng)都提供了簡寫表示法，以便為您節(jié)省一些鍵入時(shí)間。假設(shè) help 標(biāo)志的簡寫表示法是 ?，則您可以如下所示列出 csc.exe 的選項(xiàng)：

csc –?csc /?

很多選項(xiàng)都需要附加的修飾，例如，目錄路徑和文件名。這種性質(zhì)的標(biāo)志使用冒號(hào)將標(biāo)志與它的修飾分隔開來。例如，/reference 選項(xiàng)要求將 .NET 程序集的名稱包括在程序集清單中：

csc /reference:MyLibrary.dll ...

其他標(biāo)志在性質(zhì)上是二元 的，因?yàn)樗鼈兓蛘弑粏⒂?(+)，或者被禁用 (-)。二元標(biāo)志總是默認(rèn)為它們的禁用狀態(tài)，因此您通常只需要使用加號(hào)標(biāo)記。例如，要將所有編譯警告都視為錯(cuò)誤，可以啟用 warnaserror 標(biāo)志：

csc /warnaserror+ ...

標(biāo)志的順序無關(guān)緊要，但是在指定輸入文件集合之前，必須列出所有標(biāo)志的集合。另外值得說明的是，在修飾和它的關(guān)聯(lián)數(shù)據(jù)之間具有額外的空格是非法 的。例如，請(qǐng)使用 /reference:MyLibrary.dll，而不要使用 /reference:MyLibrary.dll。

返回頁首

用于指定輸入和控制輸出的選項(xiàng)

我們將要分析的第一組命令行選項(xiàng)用于指定編譯器輸入（表 2）和控制得到的輸出（表 3）。請(qǐng)注意，下面的表還標(biāo)記了特定于 C# 2.0 的選項(xiàng)和任何可用的簡寫表示法。

表 2. csc.exe 的以輸入為中心的選項(xiàng)

表 3. csc.exe 的以輸出為中心的選項(xiàng)

也許用途最多的輸入/輸出選項(xiàng)是 /target。該標(biāo)志通過使用附加的修飾（表 4）告訴編譯器您對(duì)生成哪個(gè)類型的 .NET 程序集感興趣。

表 4. /target 標(biāo)志的變體

返回頁首

編譯 .NET 代碼庫

為了說明使用 csc.exe 的輸入/輸出選項(xiàng)的過程，我們將創(chuàng)建一個(gè)強(qiáng)命名的單文件程序集 (MyCodeLibrary.dll)，以定義一個(gè)名為 SimpleType 的類類型。為了展示 /doc 選項(xiàng)的作用，我們還將生成一個(gè) XML 文檔文件。

首先，請(qǐng)?jiān)隍?qū)動(dòng)器 C 上創(chuàng)建一個(gè)名為 MyCSharpCode 的新文件夾。在該文件夾中，創(chuàng)建一個(gè)名為 MyCodeLibrary 的子目錄。使用您選擇的文本編輯器（notepad.exe 就完全合乎需要）輸入以下代碼，并將該文件保存為剛剛創(chuàng)建的 C:\MyCSharpCode\MyCodeLibrary 目錄中的 simpleType.cs。

// simpleType.cs
using System;
namespace MyCodeLibrary
{  
/// <summary>  
/// Simple utility type.   
/// </summary>  
   public class SimpleType  
   {    
      /// <summary>    
      /// Print out select environment information    
      /// </summary>    
      public static void DisplayEnvironment()    
      {      
         Console.WriteLine("Location of this program: {0}",        Environment.CurrentDirectory);       
         Console.WriteLine("Name of machine: {0}",         Environment.MachineName);      
         Console.WriteLine("OS of machine: {0}",         Environment.OSVersion);      
         Console.WriteLine("Version of .NET: {0}",         Environment.Version);    
      }
   }
}

現(xiàn)在，打開命令提示，并且使用 cd（更改目錄）命令導(dǎo)航到 simpleType.cs 文件的位置 (C:\MyCSharpCode\MyCodeLibrary)：

cd MyCSharpCode\MyCodeLibrary

或

cd C:\MyCSharpCode\MyCodeLibrary

要將該源代碼文件編譯為名為 MyCodeLibrary.dll 的單文件程序集，請(qǐng)指定以下命令集：

csc /t:library /out:MyCodeLibrary.dll simpleType.cs

此時(shí)，您應(yīng)當(dāng)在應(yīng)用程序目錄中具有一個(gè)全新的 .NET 代碼庫，如圖 2 所示。

圖 2. 新的 .NET 代碼庫

當(dāng)在命令行編譯多個(gè) C# 文件時(shí)，可以分別列出每個(gè)文件 — 如果您希望編譯包含在單個(gè)目錄中的 C# 文件的子集，則這可能有所幫助。假設(shè)我們已經(jīng)創(chuàng)建了另外一個(gè)名為 asmInfo.cs 的 C# 代碼文件（保存在同一目錄中），它定義了下列程序集級(jí)別屬性以描述我們的代碼庫：

// asmInfo.cs
using System;
using System.Reflection;
// A few assembly level attributes.
[assembly:AssemblyVersion("1.0.0.0")]
[assembly:AssemblyDescription("Just an example library")]
[assembly:AssemblyCompany("Intertech Training")]

要只編譯 simpleType.cs 和 asmInfo.cs 文件，請(qǐng)鍵入：

csc /t:library /out:MyCodeLibrary.dll simpleType.cs asmInfo.cs

正如您可能希望的那樣，csc.exe 支持通配符表示法。因而，要編譯單個(gè)目錄中的所有文件，請(qǐng)僅將 *.cs 指定為輸入選項(xiàng)：

csc /t:library /out:MyCodeLibrary.dll *.cs

使用 /recurse 指定子目錄

在創(chuàng)建應(yīng)用程序時(shí)，您肯定喜歡為您的項(xiàng)目創(chuàng)建邏輯目錄結(jié)構(gòu)。您可以通過將代碼文件放到特定的子目錄（\Core、\AsmInfo、\MenuSystem 等等）中對(duì)它們進(jìn)行組織，而不是將多達(dá) 25 個(gè)文件轉(zhuǎn)儲(chǔ)到名為 myApp 的單個(gè)目錄中。盡管我們的當(dāng)前示例只包含幾個(gè)文件，但假設(shè)您將 AsmInfo.cs 文件放到一個(gè)名為 \AsmInfo 的新的子目錄（如圖 3 所示）中。

圖 3. 新的 \AsmInfo 子目錄

要告訴 C# 編譯器編譯位于根目錄以及 AsmInfo 子目錄中的所有 C# 文件，請(qǐng)使用 /recurse 選項(xiàng)：

csc /t:library /out:MyCodeLibrary.dll /recurse:AsmInfo /doc:myDoc.xml *.cs

這里，/recurse 已經(jīng)用特定子目錄的名稱限定。要指定多個(gè)子目錄，我們可以再次使用通配符語法。如果我們要將 simpleType.cs 文件移到一個(gè)新的名為 Core 的子目錄中，則我們可以用以下命令集編譯所有子目錄中的所有 C# 文件：

csc /t:library /out:MyCodeLibrary.dll /recurse:*.cs

在任何一種情況下，輸出都是相同的。

使用 /doc 生成 XML 文檔文件

SimpleType 類已經(jīng)配備了各種 XML 元素。就像您很可能知道的那樣，C# 編譯器將使用這些帶有三條斜杠的代碼注釋生成 XML 文檔文件。要告訴 csc.exe 創(chuàng)建這樣的文件，必須提供 /doc 選項(xiàng)，并且用要生成的文件的名稱修飾它：

csc /t:library /out:MyCodeLibrary.dll /recurse:*.cs /doc:myDoc.xml

在應(yīng)用程序目錄中，您現(xiàn)在應(yīng)當(dāng)看到一個(gè)名為 myDoc.xml 的新文件。如果您打開該文件，則會(huì)發(fā)現(xiàn)您的類型以 XML 的形式進(jìn)行了說明，如圖 5 所示。

圖 5. XML 形式的類型文檔

注 如果您希望了解 C# XML 代碼注釋的詳細(xì)信息，則請(qǐng)參閱文章 XML Comments Let You Build Documentation Directly From Your Visual Studio .NET Source Files。

使用 /keyfile 建立強(qiáng)名稱

當(dāng)前示例的最后一項(xiàng)任務(wù)是為我們的程序集分配一個(gè)強(qiáng)名稱。在 .NET 1.1 下，創(chuàng)建強(qiáng)命名程序集需要使用[AssemblyKeyFile] 屬性。盡管這樣做就很好了，但 C# 2.0 編譯器現(xiàn)在提供了 /keyfile 標(biāo)志，以指定強(qiáng)名稱密鑰文件 (*.snk) 的位置。

在驅(qū)動(dòng)器 C 上創(chuàng)建一個(gè)名為 MyKeyPair 的新文件夾，然后使用命令提示更改至該目錄。接下來，使用 sn.exe 實(shí)用工具的 a€“k 選項(xiàng)創(chuàng)建一個(gè)名為 myKeyPair.snk 的新密鑰對(duì)。

sn -k myKeyPair.snk

要使用 csc.exe 對(duì) MyCodeLibrary.dll 進(jìn)行強(qiáng)命名，請(qǐng)發(fā)出以下命令集：

csc /t:library /out:MyCodeLibrary.dll /recurse:*.cs /doc:myDoc.xml /keyfile:C:\MyKeyPair\myKeypair.snk

要驗(yàn)證該程序集的確具有強(qiáng)名稱，請(qǐng)使用安全實(shí)用工具 (secutil.exe) 和 a€“s 選項(xiàng)顯示強(qiáng)名稱信息：

secutil /sMyCodeLibrary.dll

您應(yīng)當(dāng)發(fā)現(xiàn)，程序集清單中記錄的公鑰值被顯示為如圖 6 所示的輸出。

圖 6. 公鑰值的輸出

C# 2.0 編譯器確實(shí)還有其他一些以強(qiáng)名稱為中心的標(biāo)志（/delaysign 和 /keycontainer），您可能希望在空閑時(shí)加以研究。特別地，如果您希望啟用延遲簽名，則請(qǐng)使用 /delaysign 選項(xiàng)。

返回頁首

使用 C# 響應(yīng)文件

盡管通過命令行工作時(shí)可以體驗(yàn)到其與生俱來的優(yōu)勢，但沒有人能夠否認(rèn)鍵入數(shù)十個(gè)編譯器選項(xiàng)可能導(dǎo)致手指抽筋和錄入錯(cuò)誤。為了有助于減輕這兩個(gè)問題，C# 編譯器支持使用響應(yīng)文件。

注 所有命令提示都允許您使用 Up 和 Down 箭頭鍵遍歷以前的命令。

響應(yīng)文件（它們按照約定采用 *.rsp 文件擴(kuò)展名）包含您希望供給到 csc.exe 中的所有選項(xiàng)。在創(chuàng)建了該文件以后，您就可以將它的名稱指定為 C# 編譯器的唯一選項(xiàng)。為了便于說明，下面提供了一個(gè)將用于生成 MyCodeLibrary.dll 的響應(yīng)文件（請(qǐng)注意，您可以使用 # 符號(hào)指定注釋）。

# MyCodeLibraryArgs.rsp
## These are the options used
# to compile MyCodeLibrary.dll
# Output target and name.
/t:library /out:MyCodeLibrary.dll 
# Location of C
# files. 
/recurse:*.cs 
# Give me an XML doc.
/doc:myDoc.xml 
# Give me a strong name as well. 
/keyfile:C:\MyKeyPair\myKeypair.snk

給定該文件以后，您現(xiàn)在就可以使用 @ 選項(xiàng)指定 MyCodeLibraryArgs.rsp 了：

csc @MyCodeLibraryArgs.rsp

如果您愿意，則可以指定多個(gè)響應(yīng)文件：

csc @MyCodeLibraryArgs.rsp @MoreArgs.rsp @EvenMoreArgs.rsp

請(qǐng)記住，按照遇到的順序?qū)憫?yīng)文件進(jìn)行處理。因此，以前的文件中的設(shè)置可能被以后的文件中的設(shè)置重寫。

默認(rèn)的響應(yīng)文件和 /noconfig 選項(xiàng)

最后，請(qǐng)記住有一個(gè)默認(rèn)的響應(yīng)文件 — csc.rsp，它由 csc.exe 在每次編譯期間自動(dòng)處理。如果您分析該文件（它與 csc.exe 本身位于相同的文件夾中）的內(nèi)容，則您將只是發(fā)現(xiàn)一組經(jīng)常引用的程序集（System.Windows.Forms.dll、System.Data.dll 等等）。

在您希望禁止包括 csc.rsp 的極少數(shù)的場合中，您可以指定 /noconfig 標(biāo)志：

csc /noconfig @MyCodeLibraryArgs.rsp

注 如果您引用程序集，而實(shí)際上并不使用它，則它將不會(huì)在程序集清單中列出。因此，請(qǐng)不要擔(dān)心代碼膨脹問題，因?yàn)樗鼈兏静淮嬖凇?/p>

返回頁首

使用 /reference 引用外部程序集

此時(shí)，我們已經(jīng)使用命令行編譯器創(chuàng)建了具有強(qiáng)名稱（并且進(jìn)行了說明）的單文件代碼庫?，F(xiàn)在，我們需要一個(gè)客戶端應(yīng)用程序以便使用它。請(qǐng)?jiān)?C:\MyCSharpCode 中創(chuàng)建一個(gè)名為 MyClient 的新文件夾。在該文件夾中，創(chuàng)建一個(gè)新的 C# 代碼文件 (simpleTypeClient.cs)，該文件從程序的入口點(diǎn)調(diào)用靜態(tài)的SimpleType.DisplayEnvironment() 方法：

// simpleTypeClient.cs
using System;
// Namespace in MyCodeLibrary.dll
using MyCodeLibrary;  
namespace MyClientApp
{  
   public class MyApp  
   {    
      public static void Main()    
      {      
         SimpleType.DisplayEnvironment();      
         Console.ReadLine();    
      }  
   }
}

因?yàn)槲覀兊目蛻舳藨?yīng)用程序要使用 MyCodeLibrary.dll，所以我們需要使用 /reference（或只是使用 /r）選項(xiàng)。該標(biāo)志很靈活，因?yàn)槟梢灾付ㄋ懻摰?*dll 的完整路徑，如下所示：

csc /t:exe /r:C:\MyCSharpCode\MyCodeLibrary\MyCodeLibrary.dll *.cs

或者，如果私有程序集的副本與輸入文件位于相同的文件夾中，則可以只指定程序集名稱：

csc /t:exe /r:MyCodeLibrary.dll *.cs

請(qǐng)注意，我沒有指定 /out 選項(xiàng)。給定該條件，csc.exe 基于我們的初始輸入文件 (simpleTypeClient.cs) 創(chuàng)建了一個(gè)名稱。此外，已知 /target 的默認(rèn)行為是生成基于控制臺(tái)的應(yīng)用程序，所以 /t:exe 參數(shù)是可選的。

在任何情況下，因?yàn)?MyCodeLibrary.dll 是私有程序集，所以您需要將該庫的一個(gè)副本放到 MyClient 目錄中。在您完成該工作以后，您就能夠執(zhí)行 simpleTypeClient.exe 應(yīng)用程序。圖 7 顯示了可能的測試運(yùn)行。

圖 7. 可能的測試運(yùn)行輸出

注 請(qǐng)回憶一下這個(gè)問題，不必將具有強(qiáng)名稱的程序集部署到全局程序集緩存 (GAC) 中。實(shí)際上，因?yàn)閺?qiáng)名稱具有天然的安全性方面的好處，所以向每個(gè)程序集（無論共享與否）提供強(qiáng)名稱是一種 .NET 最佳策略。

引用多個(gè)外部程序集

如果您希望在命令行引用大量程序集，則可以指定多個(gè) /reference 選項(xiàng)。為了說明這一點(diǎn)，假設(shè)我們的客戶端應(yīng)用程序需要使用包含在名為 NewLib.dll 的庫中的類型：

csc /t:exe /r:MyCodeLibrary.dll /r:NewLib.dll *.cs

作為一種稍微簡單一些的替代方法，您可以使用單個(gè) /reference 選項(xiàng)，并且使用分號(hào)分隔的列表指定每個(gè)程序集：

csc /t:exe /r:MyCodeLibrary.dl;NewLib.dll *.cs

當(dāng)然，在創(chuàng)作 C# 響應(yīng)文件時(shí)使用相同的語法。

關(guān)于 /lib 的簡短說明

在查看 C# 2.0 程序集別名的作用之前，請(qǐng)?jiān)试S我對(duì) /lib 標(biāo)志加以簡短說明。該選項(xiàng)可用于將包含由 /reference 選項(xiàng)指定的程序集的目錄告訴給 csc.exe。為了進(jìn)行說明，假設(shè)您具有三個(gè)位于驅(qū)動(dòng)器 C 的根目錄中的 *.dll 程序集。要指示 csc.exe 在 C:\ 下查找 asm1.dll、asm2.dll 和 asm3.dll，需要發(fā)出以下命令集：

csc /lib:c:\ /reference:asm1.dll;asm2.dll;asm3.dll *.cs

如果您未使用 /lib，則需要將這三個(gè) .NET 代碼庫手動(dòng)復(fù)制到包含輸入文件的目錄中。還請(qǐng)注意，如果在給定的命令集中多次發(fā)出 /lib 標(biāo)志，則結(jié)果將累積起來。

返回頁首

理解 C# 2.0 引用別名

關(guān)于 /reference 選項(xiàng)需要進(jìn)行的最后一點(diǎn)說明是，在 C# 2.0 中，現(xiàn)在可以為引用的程序集創(chuàng)建別名。通過該功能，可以解決在唯一命名的程序集中包含的名稱完全相同的類型之間存在的名稱沖突問題。

為了說明該功能的實(shí)用性，請(qǐng)?jiān)?C:\MyCSharpCode 目錄中創(chuàng)建一個(gè)名為 MyCodeLibrary2 的新文件夾。將現(xiàn)有的 simpleType.cs 和 AsmInfo.cs 文件的副本放到新目錄中?，F(xiàn)在，向 SimpleType 中添加一個(gè)能夠顯示客戶端提供的字符串的新方法：

/// <summary>
/// Display a user supplied message.
/// </summary>
public static void PrintMessage(string msg)
{ 
   Console.WriteLine("You said: {0}", msg);
}

編譯這些文件，以創(chuàng)建一個(gè)名為 MyCodeLibrary2.dll 的新程序集，如下所示：

csc /t:library /out:MyCodeLibrary2.dll *.cs

最后，將這一新代碼庫的副本放到 MyClient 文件夾（圖 8）中。

圖 8. MyClient 文件夾中的新代碼

現(xiàn)在，如果我們的當(dāng)前客戶端程序希望引用 MyCodeLibrary.dll 以及 MyCodeLibrary2.dll，則我們執(zhí)行以下操作：

csc /t:exe /r:MyCodeLibrary.dll;MyCodeLibrary2.dll *.cs

編譯器告訴我們，我們已經(jīng)引入了名稱沖突，因?yàn)檫@兩個(gè)程序集都定義了一個(gè)名為 SimpleType 的類：

simpleTypeClient.cs(13,7): 
error CS0433: 
The type 'MyCodeLibrary.SimpleType'  exists in both 'c:\MyCSharpCode\MyClient\MyCodeLibrary.dll' 
and  'c:\MyCSharpCode\MyClient\MyCodeLibrary2.dll'

乍看起來，您可能認(rèn)為可以通過在客戶端代碼中使用完全限定名稱來修復(fù)該問題。但是，這樣做無法糾正該問題，因?yàn)檫@兩個(gè)程序集定義了相同的完全限定名稱 (MyCodeLibrary。SimpleType)。

使用 /reference 標(biāo)志的新別名選項(xiàng)，我們可以為引用的每個(gè)代碼庫生成唯一的名稱。在我們這樣做之后，我們就可以更新客戶端代碼，以便將某個(gè)類型與特定的程序集相關(guān)聯(lián)。

第一步是修改 simpleTypeClient.cs 文件，以使用我們將通過新的 extern alias 語法在命令行指定的別名：

// Extern alias statements must be 
// listed before all other code!extern alias ST1;  
extern alias ST2;using System;
namespace MyClientApp
{  
   public class MyApp  
   {    
      public static void Main()    
      {      
         // Bind assembly to type using the '::' operator.       
         ST1::MyCodeLibrary.SimpleType.DisplayEnvironment();      
         ST2::MyCodeLibrary.SimpleType.PrintMessage("Hello!");      
         Console.ReadLine();    
      }  
   }
}

請(qǐng)注意，我們已經(jīng)使用 C# 2.0 extern alias 語句捕獲了在命令行定義的別名。這里，ST1（簡單類型 1）是為 MyCodeLibrary.dll 定義的別名，而 ST2 是 MyCodeLibrary2.dll 的別名：

csc /r:ST1=MyCodeLibrary.dll /r:ST2=MyCodeLibrary2.dll *.cs

給定這些別名，請(qǐng)注意 Main() 方法如何使用 C# 2.0 范圍解析運(yùn)算符 (::) 將程序集別名綁定到類型本身：

// This says "I want the MyCodeLibrary.SimpleType class 
// that is defined in MyCodeLibrary.dll".
ST1::MyCodeLibrary.SimpleType.DisplayEnvironment();

進(jìn)而，/reference 選項(xiàng)的這一變體可以提供一種避免名稱沖突（當(dāng)兩個(gè)具有唯一名稱的程序集包含名稱完全相同的類型時(shí)發(fā)生）的方式。

返回頁首

使用 /addmodule 生成多文件程序集

就像您可能已經(jīng)知道的那樣，多文件程序集提供了一種將單個(gè) .NET 二進(jìn)制文件分解為多個(gè)較小的小文件的方式，這在遠(yuǎn)程下載 .NET 模塊時(shí)證明很有幫助。多文件程序集的最終效果是讓一組文件像一個(gè)單獨(dú)引用和進(jìn)行版本控制的單元那樣工作。

多文件程序集包含一個(gè)主 *.dll，它包含程序集清單。該多文件程序集的其他模塊（按照約定，它們采用 *.netmodule 文件擴(kuò)展名）被記錄在主模塊的清單中，并且由 CLR 按需加載。迄今為止，生成多文件程序集的唯一方式是使用命令行編譯器。

為了說明該過程，請(qǐng)?jiān)?C:\MyCSharpCode 目錄中創(chuàng)建一個(gè)名為 MultiFileAsm 的新子目錄。我們的目標(biāo)是創(chuàng)建一個(gè)名為 AirVehicles 的多文件程序集。主模塊 (Airvehicles.dll) 將包含單個(gè)名為 Helicopter 的類類型（稍后定義）。程序集清單編錄了一個(gè)附加模塊 (ufos.netmodule)，該模塊定義了一個(gè)名為 UFO 的類類型：

// ufo.cs
using System;
using System.Windows.Forms;
namespace AirVehicles
{     
   public class UFO     
   {          
      public void AbductHuman()          
      {               
         MessageBox.Show("Resistance is futile");          
      }     
   }
}

要將 ufo.cs 編譯為 .NET 模塊，請(qǐng)指定 /t:module 作為目標(biāo)類型，這會(huì)自動(dòng)遵循 *.netmodule 命名約定（請(qǐng)回想一下，默認(rèn)的響應(yīng)文件自動(dòng)引用 System.Windows.Forms.dll，因此我們不需要顯式引用該庫）：

csc /t:module ufo.cs

如果您要將 ufo.netmodule 加載到 ildasm.exe 中，您會(huì)發(fā)現(xiàn)一個(gè)記載了該模塊的名稱和外部引用程序集的模塊級(jí)別清單（請(qǐng)注意，*.netmodules 沒有指定版本號(hào)，因?yàn)槟鞘侵髂K的工作）：

.assembly extern mscorlib{...}.assembly extern System.Windows.Forms{...}.module ufo.netmodule

現(xiàn)在，請(qǐng)創(chuàng)建一個(gè)名為 helicopter.cs 的新文件，該文件將用于編譯主模塊 Airvehicles.dll：

// helicopter.cs
using System;
using System.Windows.Forms;
namespace AirVehicles
{     
   public class Helicopter     
   {          
      public void TakeOff()             
      {              
          MessageBox.Show("Helicopter taking off!");          
      }     
   }
}

假設(shè) Airvehicles.dll 是該多文件程序集的主模塊，則您將需要指定 /t:library 標(biāo)志。但是，因?yàn)槟€希望將 ufo.netmodule 二進(jìn)制文件編碼到程序集清單中，所以您還必須指定 /addmodule 選項(xiàng)：

csc /t:library /addmodule:ufo.netmodule /out:airvehicles.dll helicopter.cs

如果您要分析 airvehicles.dll 二進(jìn)制文件內(nèi)部包含的程序集級(jí)別清單（使用 ildasm.exe），則會(huì)發(fā)現(xiàn) ufo.netmodule 確實(shí)是使用 .file CIL 指令記錄的：

.assembly airvehicles{...}.file ufo.netmodule

多文件程序集的使用者可以較少關(guān)心他們要引用的程序集由大量二進(jìn)制文件組成這一事實(shí)。實(shí)際上，在句法上將看起來與使用單文件程序集的行為完全相同。為了使本文變得更有趣一些，讓我們創(chuàng)建一個(gè)基于 Windows 窗體的客戶端應(yīng)用程序。

返回頁首

創(chuàng)建 Windows 窗體應(yīng)用程序

我們的下一個(gè)示例項(xiàng)目將是一個(gè)使用 airvehicles.dll多文件程序集的 Windows 窗體應(yīng)用程序。在 C:\MyCSharpCode 目錄中創(chuàng)建一個(gè)名為 WinFormClient 的新的子目錄。創(chuàng)建一個(gè)派生自 Form 的類，該類定義了單個(gè) Button 類型，當(dāng)它被單擊時(shí)，將創(chuàng)建 Helicopter 和 UFO 類型，并且調(diào)用它們的成員：

using System;
using System.Windows.Forms;
using AirVehicles;
public class MyForm : Form
{  
   private Button btnUseVehicles = new Button();  
   public MyForm()  
   {    
      this.Text = "My Multifile Asm Client";    
      btnUseVehicles.Text = "Click Me";    
      btnUseVehicles.Width = 100;    
      btnUseVehicles.Height = 100;    
      btnUseVehicles.Top = 10;    
      btnUseVehicles.Left = 10;    
      btnUseVehicles.Click += new EventHandler(btnUseVehicles_Click);    
      this.Controls.Add(btnUseVehicles);  
   }  
   
   private void btnUseVehicles_Click(object o, EventArgs e)  
   {    
      Helicopter h = new Helicopter();    
      h.TakeOff();    UFO u = new UFO();    
      u.AbductHuman();  
   }
   
   private static void Main()  {    Application.Run(new MyForm());  }}

注 在繼續(xù)操作之前，請(qǐng)確保將 airvehicals.dll 和 ufo.netmodule 二進(jìn)制文件復(fù)制到 WinFormClient 目錄中。

要將該應(yīng)用程序編譯為 Windows 窗體可執(zhí)行文件，請(qǐng)確保指定 winexe 作為 /target 標(biāo)志的修飾。請(qǐng)注意，在引用多文件程序集時(shí)，只須指定主模塊的名稱：

csc /t:winexe /r:airvehicles.dll *.cs

在運(yùn)行您的程序并單擊按鈕之后，您就應(yīng)當(dāng)看到按照預(yù)期顯示的每個(gè)消息框。圖 9 顯示了我創(chuàng)建的一個(gè)消息框。

圖 9. 示例消息框

返回頁首

通過 csc.exe 使用資源

下一個(gè)議程是分析如何使用 csc.exe 將資源（例如，字符串表或圖像文件）嵌入到 .NET 程序集中。首先，可以使用 /win32Icon 選項(xiàng)指定 Win32 *.ico 文件的路徑。假設(shè)您已經(jīng)將一個(gè)名為 HappyDude.ico 的圖標(biāo)文件放到當(dāng)前 Windows 窗體應(yīng)用程序的應(yīng)用程序目錄中。要將 HappyDude.ico 設(shè)置為可執(zhí)行文件的圖標(biāo)，請(qǐng)發(fā)出以下命令集：

csc /t:winexe /win32icon:HappyDude.ico /r:airvehicles.dll *.cs

此時(shí)，應(yīng)當(dāng)更新可執(zhí)行程序集，如圖 10 所示。

圖 10. 經(jīng)過更新的可執(zhí)行程序集

除了使用 /win32icon 分配應(yīng)用程序圖標(biāo)以外，csc.exe 還提供了三個(gè)附加的以資源為中心的選項(xiàng)（表 5）。

表 5. csc.exe 的以資源為中心的選項(xiàng)

在我們了解如何將資源嵌入到我們的程序集中以前，請(qǐng)讓我對(duì) .NET 平臺(tái)中的資源的性質(zhì)進(jìn)行簡短的介紹。正如您可能已經(jīng)知道的那樣，.NET 資源開始時(shí)通常呈現(xiàn)為一組被記錄為 XML（*.resx 文件）或簡單文本 (*.txt) 的名稱/值對(duì)。該 XML/文本文件隨后被轉(zhuǎn)換為等效的二進(jìn)制文件，它采用 *.resources 文件擴(kuò)展名。然后，這些二進(jìn)制文件被嵌入到程序集中并且被記錄在清單中。當(dāng)需要以編程方式從該程序集中讀取資源的時(shí)候，System.Resources 命名空間會(huì)提供很多類型來完成該工作，其中最值得注意的是 ResourceManager 類。

盡管您肯定可以手動(dòng)創(chuàng)建 *.resx 文件，但您最好使用 resgen.exe 命令行工具（或者，您當(dāng)然可以使用 Visual Studio .NET 本身）。雖然本文不打算描述 resgen.exe 的全部詳細(xì)信息，但是讓我們演練一個(gè)簡單的示例。

使用 /resource 嵌入資源

在 MyCSharpCode 下面創(chuàng)建一個(gè)名為 MyResourceApp 的新目錄。在該目錄中，使用 notepad.exe 創(chuàng)建一個(gè)名為 myStrings.txt 的新文件，并且使其包含您選擇的一些有趣的名稱/值對(duì)。例如：

# A list of personal data
#company=Intertech 
TraininglastClassTaught=.NET SecuritylastPresentation=SD East Best PracticesfavoriteGameConsole=XBoxfavoriteComic=Cerebus

現(xiàn)在，使用命令提示，通過以下命令將 *.txt 文件轉(zhuǎn)換為一個(gè)基于 XML 的 *.resx 文件：

resgen myStrings.txt myStrings.resx

如果您使用 notepad.exe 打開該文件，則會(huì)找到許多描述名稱/值對(duì)的 XML 元素，例如：

<data name="company">  
<value xml:space="preserve">Intertech Training</value>
</data><data name="lastClassTaught">  
<value xml:space="preserve">.NET Security</value>
</data>

要將該 *.resx 文件轉(zhuǎn)換為二進(jìn)制的 *.resources 文件，只須將文件擴(kuò)展名作為 resgen.exe 的參數(shù)進(jìn)行更新：

resgen myStrings.resx myStrings.resources

此時(shí)，我們具有了一個(gè)名為 myStrings.resources 的二進(jìn)制資源文件。通過 /resource 標(biāo)志可以達(dá)到使用 csc.exe 將該數(shù)據(jù)嵌入到 .NET 程序集中的目的。假設(shè)我們已經(jīng)創(chuàng)作了位于 MyResourceApp 目錄中的以下 C# 文件 (resApp.cs)：

// This simple app reads embedded
// resources and displays them to the 
// console.
using System;
using System.Resources;
using System.Reflection;
public class ResApp
{  
   private static void Main()  
   {    
      ResourceManager rm = new ResourceManager("myStrings", Assembly.GetExecutingAssembly());
      Console.WriteLine("Last taught a {0} class.",      rm.GetString("lastClassTaught"));  
   }
}

要相對(duì)于您的myStrings.resources 文件編譯該程序集，請(qǐng)輸入以下命令：

csc /resource:myStrings.resources *.cs

因?yàn)槲疑形粗付?/out 標(biāo)志，所以在該示例中，我們的可執(zhí)行文件的名稱將基于定義了 Main() 的文件 resApp.exe。如果一切正常，則在執(zhí)行以后，您應(yīng)當(dāng)發(fā)現(xiàn)類似于圖 11 的輸出。

圖 11. 輸出

我希望您能夠輕松地使用 csc.exe 和所選的文本編輯器創(chuàng)建單文件和多文件 .NET 程序集（帶有資源?。Ｄ呀?jīng)學(xué)習(xí)了 csc.exe 的最常見的命令行選項(xiàng)，而本文的其余部分將分析一些不太常用但仍然有幫助的選項(xiàng)。

如果您愿意繼續(xù)學(xué)習(xí)，請(qǐng)?jiān)?nbsp;MyCSharpCode 文件夾中創(chuàng)建一個(gè)名為 FinalExample 的新目錄。

返回頁首

使用 /define 定義預(yù)處理器符號(hào)

盡管 C# 編譯器沒有真正預(yù)處理代碼，但該語言的確允許我們使用類似于 C 的預(yù)處理器符號(hào)來定義該編譯器以及與其進(jìn)行交互。使用 C# 的 #define 語法，可以創(chuàng)建能夠控制應(yīng)用程序內(nèi)部的執(zhí)行路徑的標(biāo)記。

注 必須在使用任何語句或其他 C# 類型定義之前列出所定義的符號(hào)。

為了利用常見的示例，假設(shè)您希望定義一個(gè)名為 DEBUG 的符號(hào)。為此，請(qǐng)創(chuàng)建一個(gè)名為 finalEx.cs 的新文件，并將其保存在 MyCSharpCode\FinalExample 目錄中：

// Define a 'preprocessor' symbol named DEBUG. 
#define DEBUG
using System;
public class FinalExample
{  
   public static void Main()  
   {    
      #if DEBUG      
         Console.WriteLine("DEBUG symbol defined");    
      #else
         Console.WriteLine("DEBUG not defined");    
      #endif  
   }
}

請(qǐng)注意，在我們使用 #define 定義了符號(hào)以后，我們就能夠使用 #if、#else 和 #endif 關(guān)鍵字來有條件地檢查和響應(yīng)該符號(hào)。如果您現(xiàn)在編譯該程序，則應(yīng)當(dāng)看到在 finalEx.exe 執(zhí)行時(shí)，消息“DEBUG symbol defined”顯示到控制臺(tái)上：

csc *.cs

但是，如果您注釋掉符號(hào)定義：

// #define DEBUG

則輸出將會(huì)像您預(yù)料的那樣（“DEBUG not defined”）。

在 .NET 程序集的開發(fā)和測試期間，在命令行定義符號(hào)可能有所幫助。這樣做可以快速地即時(shí)指定符號(hào)，而不必更新代碼基。為了進(jìn)行說明，假設(shè)您希望在命令行定義 DEBUG 符號(hào)，則請(qǐng)使用 /define 選項(xiàng)：

csc /define:DEBUG *.cs

當(dāng)您再次運(yùn)行該應(yīng)用程序時(shí)，您應(yīng)當(dāng)看到顯示“DEBUG symbol defined”— 即使 #define 語句已經(jīng)被注釋掉。

返回頁首

csc.exe 的以調(diào)試為中心的選項(xiàng)

即使是最好的程序員，有時(shí)也會(huì)發(fā)現(xiàn)有對(duì)他們的代碼基進(jìn)行調(diào)試的需要。盡管我假設(shè)大多數(shù)讀者更喜歡使用 Visual Studio .NET 進(jìn)行調(diào)試活動(dòng)，但對(duì) csc.exe 的一些以調(diào)試為中心的選項(xiàng)（表 6）進(jìn)行說明是值得的。

表 6. csc.exe 的以調(diào)試為中心的選項(xiàng)

要說明 /debug 選項(xiàng)的用法，我們首先需要在我們的 finalEx.cs 代碼文件中插入一些編碼錯(cuò)誤。請(qǐng)將以下代碼添加到當(dāng)前的 Main() 方法中：

// Create an array.
string[] myStrings = {"Csc.exe is cool"};
// Go out of bounds.
Console.WriteLine(myStrings[1]);

正如您可以看到的那樣，我們?cè)噲D使用越界索引訪問我們的數(shù)組的內(nèi)容。如果您重新編譯和運(yùn)行該程序，則會(huì)得到 IndexOutOfRangeException。盡管我們可以明顯地指出該錯(cuò)誤，但假如是一個(gè)不那么明顯的更為復(fù)雜的錯(cuò)誤，又該怎么辦呢？

要調(diào)試使用 csc.exe 創(chuàng)建的程序集，第一步是生成包含各種 .NET 調(diào)試實(shí)用工具所需信息的 *.pdb 文件。為此，請(qǐng)輸入下列命令（它們?cè)诠δ苌鲜堑刃У模┲唬?/p>

csc /debug *.cscsc /debug+ *.cs

此時(shí)，您應(yīng)當(dāng)在應(yīng)用程序目錄中看到一個(gè)名為 finalEx.pdb 的新文件，如圖 12 所示。

圖 12. 應(yīng)用程序目錄中的新 finalEx.pdb

可以根據(jù)情況用 full 或 pdbonly 標(biāo)記限定 /debug 標(biāo)志。當(dāng)您指定 /debug:full（它是默認(rèn)標(biāo)記）時(shí)，將以適當(dāng)?shù)姆绞綄?duì)程序集進(jìn)行修改，以使其可以附加到當(dāng)前正在執(zhí)行的調(diào)試器。既然該選項(xiàng)能夠 影響所產(chǎn)生的 .NET 程序集的大小和速度，那么請(qǐng)確保只在調(diào)試過程中指定該選項(xiàng)。因?yàn)?full 是 /debug 標(biāo)志的默認(rèn)行為，所以上述所有選項(xiàng)在功能上是等效的：

csc /debug *.cscsc /debug+ *.cscsc /debug:full *.cs

另一方面，指定 /debug:pdbonly 可以生成一個(gè) *.pdb 文件，以及一個(gè)只能在程序由調(diào)試工具直接啟動(dòng)時(shí)進(jìn)行調(diào)試的程序集：

csc /debug:pdbonly *.cs

在任何情況下，既然您具有必需的 *.pdb 文件，那么您就可以使用許多調(diào)試工具（cordbg.exe、dbgclr.exe 或 Visual Studio）調(diào)試應(yīng)用程序。為了不偏離本文的重點(diǎn)介紹命令行這一特征，我們將使用 cordbg.exe 實(shí)用工具調(diào)試該程序：

cordbg finalEx.exe

在調(diào)試會(huì)話開始以后，您就可以使用 so（單步執(zhí)行）命令單步執(zhí)行每個(gè)代碼行了。當(dāng)您單擊出錯(cuò)的代碼行時(shí)，您可以找到如圖 13 所示的代碼轉(zhuǎn)儲(chǔ)。

圖 13. 單步執(zhí)行命令代碼轉(zhuǎn)儲(chǔ)

要終止 cordbg.exe 實(shí)用工具，請(qǐng)鍵入 exit 并按 Return 鍵。

注 本文的重點(diǎn)不是解釋 .NET 調(diào)試工具的用法。如果您希望了解有關(guān)在命令行進(jìn)行調(diào)試的過程的更多信息，請(qǐng)?jiān)?Visual Studio 幫助系統(tǒng)內(nèi)查找“cordbg.exe”。

返回頁首

雜項(xiàng)

至此，您已經(jīng)了解了 C# 命令行編譯器的核心選項(xiàng)背后的詳細(xì)信息。為了使本文的內(nèi)容更加完整，表 7 簡要描述了我尚未談?wù)摰降钠溆鄻?biāo)志。

表 7. csc.exe 的其余選項(xiàng)

需要了解的是，對(duì)于絕大多數(shù) .NET 項(xiàng)目而言，表 7 中列出的選項(xiàng)只能提供非常少的好處。鑒于此，如果您需要進(jìn)一步的詳細(xì)信息，請(qǐng)參閱 MSDN。

返回頁首

小結(jié)

本文向您介紹了使用 C# 命令行編譯器生成程序集的過程。就像您已經(jīng)了解的那樣，大多數(shù)工作可以使用兩個(gè)標(biāo)志 — /target 和 /reference 完成。除了分析 csc.exe 的核心標(biāo)志以外，本文還解釋了響應(yīng)文件的好處以及多文件程序集的結(jié)構(gòu)。

盡管本文沒有提供有關(guān) csc.exe 的每個(gè)選項(xiàng)的全部詳細(xì)信息，但我希望您能夠方便地使用 Visual Studio 2005 文檔了解其余標(biāo)志。

祝您編碼愉快！

Andrew Troelsen 是一位 Microsoft MVP，他在 Intertech Training 擔(dān)任顧問和培訓(xùn)講師。Andrew 創(chuàng)作了許多著作，其中包括獲獎(jiǎng)的 C# and the .NET Platform Second Edition (Apress 2002)。他每月都為（真巧）MacTech 撰寫專欄文章，他在這些文章中研究了如何使用 SSCLI、Portible.NET 和 Mono CLI 分發(fā)在基于 Unix 的系統(tǒng)上進(jìn)行 .NET 開發(fā)。