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

scsc.exe 帶來的樂趣

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

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

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

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

表 1. csc.exe 提供的標記的類別

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

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

注 MSDN 文檔也會對您也很所幫助，因為它描述了如何在 Visual Studio（如果可用）內(nèi)部設(shè)置 csc.exe 的特定選項。

返回頁首

配置環(huán)境變量

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

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

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

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 的安裝和版本的不同而略有不同，因此請確保執(zhí)行完整性檢查。

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

csc -?ildasm -?

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

返回頁首

命令行基礎(chǔ)知識

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

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

csc –helpcsc /help

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

圖 1. 幫助標志

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

csc –?csc /?

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

csc /reference:MyLibrary.dll ...

其他標志在性質(zhì)上是二元 的，因為它們或者被啟用 (+)，或者被禁用 (-)。二元標志總是默認為它們的禁用狀態(tài)，因此您通常只需要使用加號標記。例如，要將所有編譯警告都視為錯誤，可以啟用 warnaserror 標志：

csc /warnaserror+ ...

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

返回頁首

用于指定輸入和控制輸出的選項

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

表 2. csc.exe 的以輸入為中心的選項

表 3. csc.exe 的以輸出為中心的選項

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

表 4. /target 標志的變體

返回頁首

編譯 .NET 代碼庫

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

首先，請在驅(qū)動器 C 上創(chuàng)建一個名為 MyCSharpCode 的新文件夾。在該文件夾中，創(chuàng)建一個名為 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 的單文件程序集，請指定以下命令集：

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

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

圖 2. 新的 .NET 代碼庫

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

// 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 文件，請鍵入：

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

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

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

使用 /recurse 指定子目錄

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

圖 3. 新的 \AsmInfo 子目錄

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

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

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

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

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

使用 /doc 生成 XML 文檔文件

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

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

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

圖 5. XML 形式的類型文檔

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

使用 /keyfile 建立強名稱

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

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

sn -k myKeyPair.snk

要使用 csc.exe 對 MyCodeLibrary.dll 進行強命名，請發(fā)出以下命令集：

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

要驗證該程序集的確具有強名稱，請使用安全實用工具 (secutil.exe) 和 a€“s 選項顯示強名稱信息：

secutil /sMyCodeLibrary.dll

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

圖 6. 公鑰值的輸出

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

返回頁首

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

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

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

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

# 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)在就可以使用 @ 選項指定 MyCodeLibraryArgs.rsp 了：

csc @MyCodeLibraryArgs.rsp

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

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

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

默認的響應(yīng)文件和 /noconfig 選項

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

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

csc /noconfig @MyCodeLibraryArgs.rsp

注 如果您引用程序集，而實際上并不使用它，則它將不會在程序集清單中列出。因此，請不要擔(dān)心代碼膨脹問題，因為它們根本不存在。

返回頁首

使用 /reference 引用外部程序集

此時，我們已經(jīng)使用命令行編譯器創(chuàng)建了具有強名稱（并且進行了說明）的單文件代碼庫。現(xiàn)在，我們需要一個客戶端應(yīng)用程序以便使用它。請在 C:\MyCSharpCode 中創(chuàng)建一個名為 MyClient 的新文件夾。在該文件夾中，創(chuàng)建一個新的 C# 代碼文件 (simpleTypeClient.cs)，該文件從程序的入口點調(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īng)用程序要使用 MyCodeLibrary.dll，所以我們需要使用 /reference（或只是使用 /r）選項。該標志很靈活，因為您可以指定所討論的 *dll 的完整路徑，如下所示：

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

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

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

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

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

圖 7. 可能的測試運行輸出

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

引用多個外部程序集

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

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

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

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

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

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

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

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

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

返回頁首

理解 C# 2.0 引用別名

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

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

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

編譯這些文件，以創(chuàng)建一個名為 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)引入了名稱沖突，因為這兩個程序集都定義了一個名為 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'

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

使用 /reference 標志的新別名選項，我們可以為引用的每個代碼庫生成唯一的名稱。在我們這樣做之后，我們就可以更新客戶端代碼，以便將某個類型與特定的程序集相關(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();    
      }  
   }
}

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

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

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

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

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

返回頁首

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

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

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

為了說明該過程，請在 C:\MyCSharpCode 目錄中創(chuàng)建一個名為 MultiFileAsm 的新子目錄。我們的目標是創(chuàng)建一個名為 AirVehicles 的多文件程序集。主模塊 (Airvehicles.dll) 將包含單個名為 Helicopter 的類類型（稍后定義）。程序集清單編錄了一個附加模塊 (ufos.netmodule)，該模塊定義了一個名為 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 模塊，請指定 /t:module 作為目標類型，這會自動遵循 *.netmodule 命名約定（請回想一下，默認的響應(yīng)文件自動引用 System.Windows.Forms.dll，因此我們不需要顯式引用該庫）：

csc /t:module ufo.cs

如果您要將 ufo.netmodule 加載到 ildasm.exe 中，您會發(fā)現(xiàn)一個記載了該模塊的名稱和外部引用程序集的模塊級別清單（請注意，*.netmodules 沒有指定版本號，因為那是主模塊的工作）：

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

現(xiàn)在，請創(chuàng)建一個名為 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 標志。但是，因為您還希望將 ufo.netmodule 二進制文件編碼到程序集清單中，所以您還必須指定 /addmodule 選項：

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

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

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

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

返回頁首

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

我們的下一個示例項目將是一個使用 airvehicles.dll多文件程序集的 Windows 窗體應(yīng)用程序。在 C:\MyCSharpCode 目錄中創(chuàng)建一個名為 WinFormClient 的新的子目錄。創(chuàng)建一個派生自 Form 的類，該類定義了單個 Button 類型，當(dāng)它被單擊時，將創(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ù)操作之前，請確保將 airvehicals.dll 和 ufo.netmodule 二進制文件復(fù)制到 WinFormClient 目錄中。

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

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

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

圖 9. 示例消息框

返回頁首

通過 csc.exe 使用資源

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

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

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

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

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

表 5. csc.exe 的以資源為中心的選項

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

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

使用 /resource 嵌入資源

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

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

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

resgen myStrings.txt myStrings.resx

如果您使用 notepad.exe 打開該文件，則會找到許多描述名稱/值對的 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)換為二進制的 *.resources 文件，只須將文件擴展名作為 resgen.exe 的參數(shù)進行更新：

resgen myStrings.resx myStrings.resources

此時，我們具有了一個名為 myStrings.resources 的二進制資源文件。通過 /resource 標志可以達到使用 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"));  
   }
}

要相對于您的myStrings.resources 文件編譯該程序集，請輸入以下命令：

csc /resource:myStrings.resources *.cs

因為我尚未指定 /out 標志，所以在該示例中，我們的可執(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 的最常見的命令行選項，而本文的其余部分將分析一些不太常用但仍然有幫助的選項。

如果您愿意繼續(xù)學(xué)習(xí)，請在 MyCSharpCode 文件夾中創(chuàng)建一個名為 FinalExample 的新目錄。

返回頁首

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

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

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

為了利用常見的示例，假設(shè)您希望定義一個名為 DEBUG 的符號。為此，請創(chuàng)建一個名為 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  
   }
}

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

csc *.cs

但是，如果您注釋掉符號定義：

// #define DEBUG

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

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

csc /define:DEBUG *.cs

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

返回頁首

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

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

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

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

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

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

要調(diào)試使用 csc.exe 創(chuàng)建的程序集，第一步是生成包含各種 .NET 調(diào)試實用工具所需信息的 *.pdb 文件。為此，請輸入下列命令（它們在功能上是等效的）之一：

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

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

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

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

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

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

csc /debug:pdbonly *.cs

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

cordbg finalEx.exe

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

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

要終止 cordbg.exe 實用工具，請鍵入 exit 并按 Return 鍵。

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

返回頁首

雜項

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

表 7. csc.exe 的其余選項

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

返回頁首

小結(jié)

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

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

祝您編碼愉快！

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