源程序最好有.csproj或.vbproj文件,沒(méi)有的話,要花些時(shí)間調(diào)試
下面我以VB.NET做示例講解一下:
從proj我們可以獲取以下有用信息
Settings小節(jié)中有很多配置選項(xiàng),對(duì)應(yīng)一些編譯器選項(xiàng)
<References>小節(jié)中是項(xiàng)目的引用,第3方類庫(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文件,那么可以用下面的命令獲取:
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)名稱支持。閱讀完本文的內(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ǔ)編譯器的所有方面的訪問(wèn)。例如,Visual Studio 2005 不支持生成多文件程序集。
此外,了解在命令行編譯代碼的過(guò)程,對(duì)于具有以下特征的用戶可能有用:
偏愛(à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í)。
如果您屬于上面所述的這些用戶,那么就忠實(shí)于自己的選擇并繼續(xù)讀下去吧。
C# 編譯器 csc.exe 提供了大量用于對(duì)創(chuàng)建 .NET 程序集的方式進(jìn)行控制的選項(xiàng)。站在一個(gè)較高層次來(lái)看,命令行選項(xiàng)屬于下列八個(gè)類別之一(表 1)。
表 1. csc.exe 提供的標(biāo)記的類別
C# 編譯器類別 |
定義 |
---|---|
輸出文件 |
用于控制所生成的程序集的格式、可選的 XML 文檔文件和強(qiáng)名稱信息的選項(xiàng)。 |
輸入文件 |
使用戶可以指定輸入文件和引用的程序集的選項(xiàng)。 |
資源 |
用于將任何必需的資源(例如,圖標(biāo)和字符串表)嵌入到程序集中的選項(xiàng)。 |
代碼生成 |
這些選項(xiàng)控制調(diào)試符號(hào)的生成。 |
錯(cuò)誤和警告 |
控制編譯器處理源代碼錯(cuò)誤/警告的方式。 |
語(yǔ)言 |
啟用/禁用 C# 語(yǔ)言功能(例如,不安全代碼)以及條件編譯符號(hào)的定義。 |
雜項(xiàng) |
該類別的最有趣的選項(xiàng)使您可以指定 csc.exe 響應(yīng)文件。 |
高級(jí) |
該類別指定一些更加深?yuàn)W并且通常不太重要的編譯器選項(xiàng)。 |
注 1.0 和 1.1 版本的 C# 編譯器中存在的 /incremental 標(biāo)志現(xiàn)在已過(guò)時(shí)。
在閱讀本文的過(guò)程中,您將了解每個(gè)編譯器類別中存在的核心 標(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)。
在使用任何 .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 用戶需要啟動(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ì)話框中,單擊位于 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.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ì)話框和當(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ù)了。
已經(jīng)能夠熟練地在命令行工作的用戶在使用 csc.exe 時(shí)不會(huì)有任何問(wèn)題,因而可以跳到下一節(jié)。但是,如果您使用命令行的次數(shù)很有限,那么請(qǐng)讓我說(shuō)明一些基本的詳細(xì)信息,以便進(jìn)行必要的準(zhǔn)備。
首先,可以使用反斜杠或單個(gè)短劃線指定 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)寫表示法,以便為您節(jié)省一些鍵入時(shí)間。假設(shè) help 標(biāo)志的簡(jiǎn)寫表示法是 ?,則您可以如下所示列出 csc.exe 的選項(xiàng):
csc –? csc /?
很多選項(xiàng)都需要附加的修飾,例如,目錄路徑和文件名。這種性質(zhì)的標(biāo)志使用冒號(hào)將標(biāo)志與它的修飾分隔開(kāi)來(lái)。例如,/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)志的順序無(wú)關(guān)緊要,但是在指定輸入文件集合之前,必須列出所有標(biāo)志的集合。另外值得說(shuō)明的是,在修飾和它的關(guān)聯(lián)數(shù)據(jù)之間具有額外的空格是非法 的。例如,請(qǐng)使用 /reference:MyLibrary.dll,而不要使用 /reference:MyLibrary.dll。
我們將要分析的第一組命令行選項(xiàng)用于指定編譯器輸入(表 2)和控制得到的輸出(表 3)。請(qǐng)注意,下面的表還標(biāo)記了特定于 C# 2.0 的選項(xiàng)和任何可用的簡(jiǎn)寫表示法。
表 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 |
指定要生成的程序集的名稱。如果省略該標(biāo)志,則輸出文件的名稱基于初始輸入文件的名稱(對(duì)于 *.dll 程序集而言)或定義 Main() 方法的類的名稱(對(duì)于 *.exe 程序集而言)。 |
否 |
/target (/t) |
指定要?jiǎng)?chuàng)建的程序集的文件格式。 |
否 |
/doc |
用于生成 XML 文檔文件。 |
否 |
/delaysign |
使您可以使用強(qiáng)名稱的延遲簽名生成程序集。 |
是 |
/keyfile |
指定用于對(duì)程序集進(jìn)行強(qiáng)命名的 *.snk 文件的路徑。 |
是 |
/keycontainer |
指定包含 *.snk 文件的容器的名稱。 |
是 |
/platform |
指定必須存在以便承載程序集的 CPU(x86、Itanium、x64 或 anycpu)。默認(rèn)為 anycpu。 |
是 |
也許用途最多的輸入/輸出選項(xiàng)是 /target。該標(biāo)志通過(guò)使用附加的修飾(表 4)告訴編譯器您對(duì)生成哪個(gè)類型的 .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)建將成為多文件程序集的一部分的模塊。 |
為了說(shuō)明使用 csc.exe 的輸入/輸出選項(xiàng)的過(guò)程,我們將創(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)在,打開(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)用特定子目錄的名稱限定。要指定多個(gè)子目錄,我們可以再次使用通配符語(yǔ)法。如果我們要將 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 的新文件。如果您打開(kāi)該文件,則會(huì)發(fā)現(xiàn)您的類型以 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)名稱
當(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 的新文件夾,然后使用命令提示更改至該目錄。接下來(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)名稱,請(qǐng)使用安全實(shí)用工具 (secutil.exe) 和 â?“s 選項(xiàng)顯示強(qiáng)名稱信息:
secutil /sMyCodeLibrary.dll
您應(yīng)當(dāng)發(fā)現(xiàn),程序集清單中記錄的公鑰值被顯示為如圖 6 所示的輸出。
C# 2.0 編譯器確實(shí)還有其他一些以強(qiáng)名稱為中心的標(biāo)志(/delaysign 和 /keycontainer),您可能希望在空閑時(shí)加以研究。特別地,如果您希望啟用延遲簽名,則請(qǐng)使用 /delaysign 選項(xià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)建了該文件以后,您就可以將它的名稱指定為 C# 編譯器的唯一選項(xiàng)。為了便于說(shuō)明,下面提供了一個(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ù)的場(chǎng)合中,您可以指定 /noconfig 標(biāo)志:
csc /noconfig @MyCodeLibraryArgs.rsp
注 如果您引用程序集,而實(shí)際上并不使用它,則它將不會(huì)在程序集清單中列出。因此,請(qǐng)不要擔(dān)心代碼膨脹問(wèn)題,因?yàn)樗鼈兏静淮嬖凇?/p>
返回頁(yè)首
此時(shí),我們已經(jīng)使用命令行編譯器創(chuàng)建了具有強(qiáng)名稱(并且進(jìn)行了說(shuō)明)的單文件代碼庫(kù)。現(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)注意,我沒(méi)有指定 /out 選項(xiàng)。給定該條件,csc.exe 基于我們的初始輸入文件 (simpleTypeClient.cs) 創(chuàng)建了一個(gè)名稱。此外,已知 /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)名稱的程序集部署到全局程序集緩存 (GAC) 中。實(shí)際上,因?yàn)閺?qiáng)名稱具有天然的安全性方面的好處,所以向每個(gè)程序集(無(wú)論共享與否)提供強(qiáng)名稱是一種 .NET 最佳策略。
引用多個(gè)外部程序集
如果您希望在命令行引用大量程序集,則可以指定多個(gè) /reference 選項(xiàng)。為了說(shuō)明這一點(diǎn),假設(shè)我們的客戶端應(yīng)用程序需要使用包含在名為 NewLib.dll 的庫(kù)中的類型:
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)。
關(guān)于 /reference 選項(xiàng)需要進(jìn)行的最后一點(diǎn)說(shuō)明是,在 C# 2.0 中,現(xiàn)在可以為引用的程序集創(chuàng)建別名。通過(guò)該功能,可以解決在唯一命名的程序集中包含的名稱完全相同的類型之間存在的名稱沖突問(wèn)題。
為了說(shuō)明該功能的實(shí)用性,請(qǐng)?jiān)?C:\MyCSharpCode 目錄中創(chuàng)建一個(gè)名為 MyCodeLibrary2 的新文件夾。將現(xiàn)有的 simpleType.cs 和 AsmInfo.cs 文件的副本放到新目錄中。現(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
最后,將這一新代碼庫(kù)的副本放到 MyClient 文件夾(圖 8)中。
現(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'
乍看起來(lái),您可能認(rèn)為可以通過(guò)在客戶端代碼中使用完全限定名稱來(lái)修復(fù)該問(wèn)題。但是,這樣做無(wú)法糾正該問(wèn)題,因?yàn)檫@兩個(gè)程序集定義了相同的完全限定名稱 (MyCodeLibrary。SimpleType)。
使用 /reference 標(biāo)志的新別名選項(xiàng),我們可以為引用的每個(gè)代碼庫(kù)生成唯一的名稱。在我們這樣做之后,我們就可以更新客戶端代碼,以便將某個(gè)類型與特定的程序集相關(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)單類型 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ā)生)的方式。
就像您可能已經(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 的類類型(稍后定義)。程序集清單編錄了一個(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,因此我們不需要顯式引用該庫(kù)):
csc /t:module ufo.cs
如果您要將 ufo.netmodule 加載到 ildasm.exe 中,您會(huì)發(fā)現(xiàn)一個(gè)記載了該模塊的名稱和外部引用程序集的模塊級(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 窗體的客戶端應(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è)消息框。
下一個(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) 的名稱/值對(duì)。該 XML/文本文件隨后被轉(zhuǎn)換為等效的二進(jìn)制文件,它采用 *.resources 文件擴(kuò)展名。然后,這些二進(jìn)制文件被嵌入到程序集中并且被記錄在清單中。當(dāng)需要以編程方式從該程序集中讀取資源的時(shí)候,System.Resources 命名空間會(huì)提供很多類型來(lái)完成該工作,其中最值得注意的是 ResourceManager 類。
盡管您肯定可以手動(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 的新文件,并且使其包含您選擇的一些有趣的名稱/值對(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ì)找到許多描述名稱/值對(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í)行文件的名稱將基于定義了 Main() 的文件 resApp.exe。如果一切正常,則在執(zhí)行以后,您應(yīng)當(dāng)發(fā)現(xiàn)類似于圖 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 的新目錄。
盡管 C# 編譯器沒(méi)有真正預(yù)處理代碼,但該語(yǔ)言的確允許我們使用類似于 C 的預(yù)處理器符號(hào)來(lái)定義該編譯器以及與其進(jìn)行交互。使用 C# 的 #define 語(yǔ)法,可以創(chuàng)建能夠控制應(yīng)用程序內(nèi)部的執(zhí)行路徑的標(biāo)記。
注 必須在使用任何語(yǔ)句或其他 C# 類型定義之前列出所定義的符號(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)被注釋掉。
即使是最好的程序員,有時(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使用越界索引訪問(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ì)話開(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”。
至此,您已經(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ù)類型界限的整數(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。
本文向您介紹了使用 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 撰寫專欄文章,他在這些文章中研究了如何使用 SSCLI、Portible.NET 和 Mono CLI 分發(fā)在基于 Unix 的系統(tǒng)上進(jìn)行 .NET 開(kāi)發(fā)。
聲明:本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí),若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系,我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com