源程序最好有.csproj或.vbproj文件，沒(méi)有的話(huà)，要花些時(shí)間調(diào)試
下面我以VB.NET做示例講解一下：
　　
從proj我們可以獲取以下有用信息
　　
Settings小節(jié)中有很多配置選項(xiàng)，對(duì)應(yīng)一些編譯器選項(xiàng)
<References>小節(jié)中是項(xiàng)目的引用，第3方類(lèi)庫(kù)最好用絕對(duì)路徑
<Imports>小節(jié)中是要導(dǎo)入的一些命名空間
<Files>小節(jié)中有項(xiàng)目的所有文件，選取 BuildAction = "Compile"的文件
　　
用vbc測(cè)試了一下，很容易，注意以下幾項(xiàng)：
rootnamespace
reference
target
imports
　　
加上bugreport可以將所有的源文件代碼和bug報(bào)告輸出。不錯(cuò)
　　
給你一端編譯示例：
vbc /r:System.dll /r:System.Data.dll /r:System.Drawing.dll /r:System.Web.dll /r:System.Xml.dll /r:bin\Microsoft.ApplicationBlocks.Data.dll /r:bin\ExportTechnologies.WebControls.RTE.dll /imports:Microsoft.VisualBasic /imports:System /imports:System.Collections /imports:System.Configuration /imports:System.Data /imports:System.Drawing /imports:System.Web /imports:System.Web.UI /imports:System.Web.UI.HtmlControls /imports:System.Web.UI.WebControls /imports:MMS /rootnamespace:MMS /t:library /out:Truly.MMS.dll /bugreport:bug.log AssemblyInfo.vb Global.asax.vb HDAdd.aspx.vb HDticketLogAdd.aspx.vb MIS.vb PageBase.vb Utils.vb
　　
如果沒(méi)有proj文件，那么可以用下面的命令獲?。?br /> dir /b *.vb > filelist.txt

csc的使用方法就靠你自己去琢磨了。這樣編譯出來(lái)的跟vs是有1點(diǎn)區(qū)別的，因?yàn)槲覀兒芏噙x項(xiàng)沒(méi)有配置，但是經(jīng)過(guò)測(cè)試，基本可以正常工作的。

-------------------------------------------------------------------------------------------------------

使用 C# 2.0 命令行編譯器

http://msdn.microsoft.com/zh-cn/library/ms379563(vs.80).aspx#mainSection

摘要：本文分析了使用 C# 命令行編譯器 csc.exe 生成應(yīng)用程序的過(guò)程。同時(shí)，還將向讀者介紹很多為 C# 2.0 獨(dú)有的編譯器選項(xiàng)，例如，extended/reference 標(biāo)志和強(qiáng)名稱(chēng)支持。閱讀完本文的內(nèi)容之后，您將能夠輕松地在沒(méi)有向?qū)У沫h(huán)境中生成單文件程序集和多文件程序集。

適用于：

Microsoft Visual C# 2.0

注 本文假定您熟悉 C# 編程語(yǔ)言和 .NET Framework 的結(jié)構(gòu)。體驗(yàn)一下使用命令行工具的感覺(jué)還將證明很有幫助。

下載 CSCSample.msi 文件。

scsc.exe 帶來(lái)的樂(lè)趣

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

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

• 偏愛(ài)最簡(jiǎn)單的生成 .NET Framework 應(yīng)用程序的方法。

• 希望揭開(kāi) IDE 處理源代碼文件的方法的秘密。

• 希望利用 .NET 生成實(shí)用工具，例如，nant 或 msbuild。

• 沒(méi)有集成開(kāi)發(fā)環(huán)境，例如，Visual Studio（但實(shí)際上具有免費(fèi)提供的 .NET Framework SDK）。

• 正在基于 Unix的系統(tǒng)（在該系統(tǒng)中，命令行是必須使用的工具）上使用 .NET Framework，并且希望更好地了解 Mono 和/或 Portable .NET ECMA 兼容 C# 編譯器。

• 正在研究當(dāng)前未集成到 Visual Studio 中的備選 .NET 編程語(yǔ)言。

• 只是希望擴(kuò)展他們的 C# 編程語(yǔ)言知識(shí)。

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

C# 編譯器選項(xiàng)概覽

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

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

C# 編譯器類(lèi)別	定義
輸出文件	用于控制所生成的程序集的格式、可選的 XML 文檔文件和強(qiáng)名稱(chēng)信息的選項(xiàng)。
輸入文件	使用戶(hù)可以指定輸入文件和引用的程序集的選項(xiàng)。
資源	用于將任何必需的資源（例如，圖標(biāo)和字符串表）嵌入到程序集中的選項(xiàng)。
代碼生成	這些選項(xiàng)控制調(diào)試符號(hào)的生成。
錯(cuò)誤和警告	控制編譯器處理源代碼錯(cuò)誤/警告的方式。
語(yǔ)言	啟用/禁用 C# 語(yǔ)言功能（例如，不安全代碼）以及條件編譯符號(hào)的定義。
雜項(xiàng)	該類(lèi)別的最有趣的選項(xiàng)使您可以指定 csc.exe 響應(yīng)文件。
高級(jí)	該類(lèi)別指定一些更加深?yuàn)W并且通常不太重要的編譯器選項(xiàng)。

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

在閱讀本文的過(guò)程中，您將了解每個(gè)編譯器類(lèi)別中存在的核心 標(biāo)志（最重要的詞是核心）。對(duì)于大多數(shù)開(kāi)發(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# 編譯器）之前，需要配置開(kāi)發(fā)計(jì)算機(jī)以識(shí)別它們的存在。最簡(jiǎn)單的方法是使用 Start | All Programs | Visual Studio 2005 | Visual Studio Tools 菜單選項(xiàng)，啟動(dòng)預(yù)配置的 Visual Studio 命令提示。這一特定的控制臺(tái)能夠自動(dòng)初始化必要的環(huán)境變量，而無(wú)須您執(zhí)行任何操作。（Visual Studio .NET 2003 用戶(hù)需要啟動(dòng)他們各自的命令提示）。

注 如果您沒(méi)有 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ì)話(huà)框中，單擊位于 Advanced 選項(xiàng)卡下面的 Environment Variables 按鈕。從出現(xiàn)的對(duì)話(huà)框中，在 System 變量列表框中的當(dāng)前 Path 變量的結(jié)尾添加以下目錄清單（請(qǐng)注意，必須用分號(hào)分隔各個(gè)條目）：

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

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

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

csc -?
ildasm -?

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

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

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

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

csc –help
csc /help

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

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

csc –?
csc /?

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

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)志的順序無(wú)關(guān)緊要，但是在指定輸入文件集合之前，必須列出所有標(biāo)志的集合。另外值得說(shuō)明的是，在修飾和它的關(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)和任何可用的簡(jiǎn)寫(xiě)表示法。

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

輸入標(biāo)志	定義	是否特定于 C# 2.0？
/recurse	通知 csc.exe 編譯位于項(xiàng)目的子目錄結(jié)構(gòu)中的 C# 文件。該標(biāo)志支持通配符語(yǔ)法。	否
/reference (/r)	用于指定要在當(dāng)前編譯中引用的外部程序集。	否，但是 2.0 編譯器提供了別名變體。
/addmodule	用于指定要包括在多文件程序集中的模塊。	否

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

輸出標(biāo)志	定義	是否特定于 C# 2.0？
/out	指定要生成的程序集的名稱(chēng)。如果省略該標(biāo)志，則輸出文件的名稱(chēng)基于初始輸入文件的名稱(chēng)（對(duì)于 *.dll 程序集而言）或定義 Main() 方法的類(lèi)的名稱(chēng)（對(duì)于 *.exe 程序集而言）。	否
/target (/t)	指定要?jiǎng)?chuàng)建的程序集的文件格式。	否
/doc	用于生成 XML 文檔文件。	否
/delaysign	使您可以使用強(qiáng)名稱(chēng)的延遲簽名生成程序集。	是
/keyfile	指定用于對(duì)程序集進(jìn)行強(qiáng)命名的 *.snk 文件的路徑。	是
/keycontainer	指定包含 *.snk 文件的容器的名稱(chēng)。	是
/platform	指定必須存在以便承載程序集的 CPU（x86、Itanium、x64 或 anycpu）。默認(rèn)為 anycpu。	是

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

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

目標(biāo)修飾	定義
/target:exe	創(chuàng)建基于控制臺(tái)的程序集。如果未指定 /target 選項(xiàng)，則這是默認(rèn)選項(xiàng)。
/target:winexe	創(chuàng)建基于 Windows 窗體的可執(zhí)行程序集。盡管您可以使用 /target:exe 創(chuàng)建 Windows 窗體應(yīng)用程序，但控制臺(tái)窗口將在主窗體的后臺(tái)隱現(xiàn)。
/target:library	用于生成 .NET 代碼庫(kù) (*.dll)。
/target:module	創(chuàng)建將成為多文件程序集的一部分的模塊。

編譯 .NET 代碼庫(kù)

為了說(shuō)明使用 csc.exe 的輸入/輸出選項(xiàng)的過(guò)程，我們將創(chuàng)建一個(gè)強(qiáng)命名的單文件程序集 (MyCodeLibrary.dll)，以定義一個(gè)名為 SimpleType 的類(lèi)類(lèi)型。為了展示 /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)在，打開(kāi)命令提示，并且使用 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 代碼庫(kù)，如圖 2 所示。

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

// 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)。您可以通過(guò)將代碼文件放到特定的子目錄（\Core、\AsmInfo、\MenuSystem 等等）中對(duì)它們進(jìn)行組織，而不是將多達(dá) 25 個(gè)文件轉(zhuǎn)儲(chǔ)到名為 myApp 的單個(gè)目錄中。盡管我們的當(dāng)前示例只包含幾個(gè)文件，但假設(shè)您將 AsmInfo.cs 文件放到一個(gè)名為 \AsmInfo 的新的子目錄（如圖 3 所示）中。

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

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

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

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

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

使用 /doc 生成 XML 文檔文件

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

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

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

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

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

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

在驅(qū)動(dòng)器 C 上創(chuàng)建一個(gè)名為 MyKeyPair 的新文件夾，然后使用命令提示更改至該目錄。接下來(lái)，使用 sn.exe 實(shí)用工具的 –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)名稱(chēng)，請(qǐng)使用安全實(shí)用工具 (secutil.exe) 和 –s 選項(xiàng)顯示強(qiáng)名稱(chēng)信息：

secutil /sMyCodeLibrary.dll

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

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

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

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

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

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

# 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è)置重寫(xiě)。

默認(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ù)的場(chǎng)合中，您可以指定 /noconfig 標(biāo)志：

csc /noconfig @MyCodeLibraryArgs.rsp

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

使用 /reference 引用外部程序集

此時(shí)，我們已經(jīng)使用命令行編譯器創(chuàng)建了具有強(qiáng)名稱(chēng)（并且進(jìn)行了說(shuō)明）的單文件代碼庫(kù)。現(xiàn)在，我們需要一個(gè)客戶(hù)端應(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)槲覀兊目蛻?hù)端應(yīng)用程序要使用 MyCodeLibrary.dll，所以我們需要使用 /reference（或只是使用 /r）選項(xiàng)。該標(biāo)志很靈活，因?yàn)槟梢灾付ㄋ懻摰?*dll 的完整路徑，如下所示：

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

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

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

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

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

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

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

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

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

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

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

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

關(guān)于 /lib 的簡(jiǎn)短說(shuō)明

在查看 C# 2.0 程序集別名的作用之前，請(qǐng)?jiān)试S我對(duì) /lib 標(biāo)志加以簡(jiǎn)短說(shuō)明。該選項(xiàng)可用于將包含由 /reference 選項(xiàng)指定的程序集的目錄告訴給 csc.exe。為了進(jìn)行說(shuō)明，假設(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 代碼庫(kù)手動(dòng)復(fù)制到包含輸入文件的目錄中。還請(qǐng)注意，如果在給定的命令集中多次發(fā)出 /lib 標(biāo)志，則結(jié)果將累積起來(lái)。

理解 C# 2.0 引用別名

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

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

/// <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

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

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

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

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

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

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

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

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

// 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 語(yǔ)句捕獲了在命令行定義的別名。這里，ST1（簡(jiǎn)單類(lèi)型 1）是為 MyCodeLibrary.dll 定義的別名，而 ST2 是 MyCodeLibrary2.dll 的別名：

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

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

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

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

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

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

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

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

// 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)類(lèi)型，這會(huì)自動(dòng)遵循 *.netmodule 命名約定（請(qǐng)回想一下，默認(rèn)的響應(yīng)文件自動(dòng)引用 System.Windows.Forms.dll，因此我們不需要顯式引用該庫(kù)）：

csc /t:module ufo.cs

如果您要將 ufo.netmodule 加載到 ildasm.exe 中，您會(huì)發(fā)現(xiàn)一個(gè)記載了該模塊的名稱(chēng)和外部引用程序集的模塊級(jí)別清單（請(qǐng)注意，*.netmodules 沒(méi)有指定版本號(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í)際上，在句法上將看起來(lái)與使用單文件程序集的行為完全相同。為了使本文變得更有趣一些，讓我們創(chuàng)建一個(gè)基于 Windows 窗體的客戶(hù)端應(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 的類(lèi)，該類(lèi)定義了單個(gè) Button 類(lèi)型，當(dāng)它被單擊時(shí)，將創(chuàng)建 Helicopter 和 UFO 類(lèi)型，并且調(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í)，只須指定主模塊的名稱(chēng)：

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

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

通過(guò) 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 所示。

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

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

csc.exe 的以資源為中心的選項(xiàng)	定義
/resource	將 *.resources 文件內(nèi)部包含的資源嵌入到當(dāng)前程序集中。請(qǐng)注意，通過(guò)該選項(xiàng)可以“以公共方式”嵌入資源以供所有使用者使用，或者“以私有方式”嵌入資源以便僅供包含程序集使用。
/linkresource	在程序集清單中記錄指向外部資源文件的鏈接，但實(shí)際上并不嵌入資源自身。
/win32res	使您可以嵌入存在于舊式 *.res 文件中的資源。

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

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

使用 /resource 嵌入資源

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

# A list of personal data
#
company=Intertech Training
lastClassTaught=.NET Security
lastPresentation=SD East Best Practices
favoriteGameConsole=XBox
favoriteComic=Cerebus

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

resgen myStrings.txt myStrings.resx

如果您使用 notepad.exe 打開(kāi)該文件，則會(huì)找到許多描述名稱(chēng)/值對(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)制資源文件。通過(guò) /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í)行文件的名稱(chēng)將基于定義了 Main() 的文件 resApp.exe。如果一切正常，則在執(zhí)行以后，您應(yīng)當(dāng)發(fā)現(xiàn)類(lèi)似于圖 11 的輸出。

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

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

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

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

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

為了利用常見(jiàn)的示例，假設(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)鍵字來(lái)有條件地檢查和響應(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 程序集的開(kāi)發(fā)和測(cè)試期間，在命令行定義符號(hào)可能有所幫助。這樣做可以快速地即時(shí)指定符號(hào)，而不必更新代碼基。為了進(jìn)行說(shuō)明，假設(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 語(yǔ)句已經(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)行說(shuō)明是值得的。

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

csc.exe 的以調(diào)試為中心的選項(xiàng)	定義
/debug	指示 csc.exe 發(fā)出一個(gè) *.pdb 文件，以供調(diào)試工具（例如，cordbg.exe、dbgclr.exe 或 Visual Studio）使用。
/warnaserror	將所有警告視為嚴(yán)重錯(cuò)誤。
/warn	使您可以指定當(dāng)前編譯的警告級(jí)別（0、1、2、3 或 4）。
/nowarn	使您可以禁用特定的 C# 編譯器警告。
/bugreport	如果應(yīng)用程序在運(yùn)行時(shí)出現(xiàn)故障，則該選項(xiàng)可生成錯(cuò)誤日志。該選項(xiàng)將提示您輸入糾正信息以發(fā)送到您希望的任何地方（例如，QA 小組）。

要說(shuō)明 /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使用越界索引訪(fǎng)問(wèn)我們的數(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 *.cs
csc /debug+ *.cs

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

可以根據(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)試過(guò)程中指定該選項(xiàng)。因?yàn)?full 是 /debug 標(biāo)志的默認(rèn)行為，所以上述所有選項(xiàng)在功能上是等效的：

csc /debug *.cs
csc /debug+ *.cs
csc /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ì)話(huà)開(kāi)始以后，您就可以使用 so（單步執(zhí)行）命令單步執(zhí)行每個(gè)代碼行了。當(dāng)您單擊出錯(cuò)的代碼行時(shí)，您可以找到如圖 13 所示的代碼轉(zhuǎn)儲(chǔ)。

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

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

雜項(xiàng)

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

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

csc.exe 的其余選項(xiàng)	定義
/baseaddress	該選項(xiàng)使您可以指定加載 *.dll 的預(yù)期基址。默認(rèn)情況下，該基址由 CLR 選擇。
/checked	指定溢出數(shù)據(jù)類(lèi)型界限的整數(shù)運(yùn)算是否會(huì)在運(yùn)行時(shí)導(dǎo)致異常。
/codepage	指定要用于編譯中的所有源代碼文件的代碼頁(yè)。
/filealign	該選項(xiàng)控制輸出程序集內(nèi)部的節(jié)大小調(diào)整（512、1024、2048、4096 或 8192 字節(jié)）。如果目標(biāo)設(shè)備是手持型設(shè)備（例如，Pocket PC），則可以使用 /filealign 指定可能存在的最小節(jié)。
/langversion	該選項(xiàng)指示編譯器只使用 ISO-1 C# 語(yǔ)言功能，它基本上可以歸結(jié)為 C# 1.0 語(yǔ)言功能。
/main	如果當(dāng)前項(xiàng)目定義了多個(gè) Main() 方法（這在單元測(cè)試期間可能有所幫助），則可以使用該標(biāo)志指定在程序集加載時(shí)執(zhí)行哪個(gè) Main() 方法。
/nostdlib	默認(rèn)情況下，程序集清單自動(dòng)引用 mscorlib.dll。指定該選項(xiàng)可以禁止這一行為。
/optimize	當(dāng)被啟用 (/optimize+) 時(shí)，可指示編譯器盡可能生成最小且最快的程序集。該選項(xiàng)會(huì)發(fā)出還指示 CLR 在運(yùn)行時(shí)優(yōu)化代碼的元數(shù)據(jù)。
/platform	該標(biāo)志告訴編譯器針對(duì) 32 位或 64 位處理器優(yōu)化程序集。一般來(lái)說(shuō)，該選項(xiàng)只在 C# 代碼基使用 P/Invoke 和/或不安全的代碼結(jié)構(gòu)時(shí)有用。默認(rèn)值是“anycpu”。
/unsafe	當(dāng)被啟用時(shí)，該選項(xiàng)使 C# 文件可以聲明不安全的作用范圍，這通常用于操縱 C++ 樣式指針。
/utf8output	該選項(xiàng)告訴編譯器使用 UTF-8 編碼輸出數(shù)據(jù)。

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

小結(jié)

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

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

祝您編碼愉快！

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