如何用CSC.exe来编译Visual C#的代码文件

【 tulaoshi.com - 编程语言 】

　　Visual C#是微软公司推出的新一代程序开发语言，Visual C#是微软公司.Net FrameWork框架中的一个重要的组成部分，也是微软公司向程序员极力推荐一个新的程序开发平台。和以往的开发语言相比较，他有更强大功能，更高的稳定性和更高的安全性。也正因为如此，Visual C#正在受到越来越多的编程爱好者的欢迎。

　　Visual C#的编译器和以往编程语言的编译器有着明显的不同。其最大的不同点就是，以往的程序编译器是把编写好的程序代码编译生成可以直接为计算机所使用的机器语言。虽然Visual C#的编译器也可以把编写好的程序代码编译成EXE或者是DLL文件，但这种文件只是一种IL文件（中间语言），此IL文件不能直接被计算机使用。只是当此IL文件被调用的时候，再通过一种名叫JIT(即时编译)编译器把此IL文件生成可以供计算机使用的机器代码。

　　可见Visual C#的编译过程大致可以分成二个部分，第一个部分，从程序代码到IL文件，这个过程是通过人工干预来实现的，即通过CSC.exe来实现的；第二个部分，从IL文件到机器语言，这个工程是机器自动实现的。本文就将具体来说明一下第一个部分，即如何用CSC.exe来正确编译Visual C#文件。

　　CSC.exe把Visual C#程序代码编译成IL文件时，有着很多参数和开关选项。正确的了解和运用这些参数和开关有时会解决一些看似很棘手的问题。下面就通过一张表来大致说明一下这些参数和开关的具体作用。这些参数和开关选项是按照字母顺序来排列的。其中带"*"，是一些常用的参数或开关。

　　选项 用途@ * 指定响应文件。/？, /help在控制台的计算机屏幕上显示编译器的选项/addmodule指定一个或多个模块为集会的一部分/baseaddress指定装入DLL的基础地址/bugreport创建一个文件，该文件包含是报告错误更加容易的信息/checked如果整数计算溢出数据类型的边界，则在运行时产生一个例外的事件/codepage指定代码页以便在编译中使用的所有源代码文件/debug *发送调试信息/define定义预处理的程序符号/doc *把处理的文档注释为XML文件/fullpaths指定编译输出文件的反正路径/incremental对源代码的文件进行增量编译/linkresource把.NET资源链接到集合中/main指定Main方法的位置/noLogo禁止使用编译器的标志信息/nooutput编译文件但不输出文件/nostdlib不导出标准库（即mscorlib.dll）/nowarn编译但编译器并不显示警告功能/optimize打开或者关闭优化/out *指定输出文件/recurse搜索编译源文件的子目录/reference *从包含集合的文件中导入元数据/target *指定输出文件的格式/unsafe编译使用非安全关键字的代码/warn设置警告级别/warnaserror提升警告为错误/win32icon插入一个.ico文件导输出文件中去/win32res插入一个Win32资源导输出文件中具体说明：

　　一．@

　　这个选项是用来指定响应文件。响应文件是一种包含了许多编译选项的文件。这些编译选项将和源代码文件一起由编译器进行处理。一般来说此种响应文件是以文本文件形式出现。他的扩展名是.rsp。在响应文件中是用＃符号表示开始的注释。

　　例：以下是一个响应文件resp1.rsp的内容：

　　# 这是一个简单的响应文件，文件名称为resp1.rsp

　　#使用方法: csc @resp1.rsp

/target:exe /out:sample.exe sample.cs

　　此响应文件的作用就是把sample.cs文件编译成sample.exe文件。如果在一次编译中要指定多个响应文件，可以指定多个响应文件选项，如：

@file1.rsp @file2.rsp

　　二．/？和/help

　　这个选项应该不必多说，那些用过DOS程序的人，大概都会用这个选项。

　　三．/addmodule

　　本选项是使编译器搜集从用户正在编译的工程到可用文件中所以类型的信息。所有添加了/addmodule的模块在运行时必须与输出文件在同一目录中。这就是说，用户可以在编译时指定任何目录中的模块，但在运行时这个模块必须在应用程序目录中。文件中不能包含汇编名单。例如：如果输出文件用/taarget:module创建，其元数据可以用/addmodule导入。

　　例子：把二个模块加入myProject.cs中

csc /addmodule:module1.dll;module2.dll myProject.cs

　　四．/baseaddress

　　本选项允许用户指定载入DLL时的首选地址，这个首选地址可以是十进制、十六进制、八进制。DLL的缺省首选地址在.Net运行时设置。如果目标文件不是DLL文件，这个选项将被忽略。

　　例子：把myLibrary.cs 编译程DLL文件，并且当此DLL在.Net运行环境被载入时的地址是0x1111000

csc /baseaddres:0x1111000 /target:library myLibrary.cs

　　这个选项用来报告编译时的错误信息。在报告中包含以下内容：

　　1）.编译中所有源代码的一个拷贝

　　2）.在编译中所有的编译选项

　　3）.编译信息，包括编译器、运行时间、操作系统的版本信息

　　4）.编译器输出

　　5）.问题的描述

　　6）.如何解决问题的描述

　　例子：生成一个bugs.txt文件，并把错误报告放在文件里面

csc /bugreport:bugs.txt Hello.cs

　　六．/checked

　　此选项指定不在检验或或者未检验关键字范围内以及导致超出数据类型范围的值的整数计算语句是否产生运行例外。具体的说就是，如果不在检验或者未检验关键字范围内的整数计算语句产生的值在数据类型允许的范围之外，并且在编译中使用了/checked+(/checked)，该语句就会在运行时产生例外，如果在编译时使用了/checked-，在运行时该语句就不会产生例外。

　　例子：编译myMath.cs，并且指定一个不在检验或者未检验关键字范围内的整数计算语句（且其产生的值超出数据类型的范围），将在运行时引起例外。

csc /checked+ myMath.cs

　　七．/codepage

　　如果用户编译的一个或者多个源代码不使用计算机上的默认代码页，可以使用/codepage选项来指定希望使用的代码页。/codepage适用于编译中所有的源代码文件。

　　如果源代码文件在计算机上的同一个代码页位置创建，或者源代码文件用UNICODE或者UTF-8来创建，用户就不需要使用/codepage了。

　　八．/debug

　　此选项是在调试时候使用的，当调试者启用了这个选项来调试自己的程序，将会创建一个.pdb文件，并把各种调试信息写到此文件里。有2中选项来指定调试的类型：

　　/debug [+/-] :当选用/debug +就会把创建.pdb文件，并把调试信息存储到里面；/debug -是一个缺省设置，就是不产生任何调试信息。

　　/debug:[full/pdbonly] :当使用/debug:full就是创建缺省的调试信息，有点类似/debug+选项。/debug: pdbonly选项是创建.pdb文件，并且你只能使用源代码调试在调试工具里。

　　例子：编译Hello.cs并且为Hello.cs创建调试信息

csc /debug+ HelloWorld.cs

　　此选项在程序中定义了一个符号，他和在源程序中使用#define预处理程序指示功能相同，此符号保持已定义状态，直到源文件中的#undef指示符删除定义或者编译器已到达了文件末尾。你可以用/d简写来代替。

　　例子：下面是my.cs的源程序

using System;public class myBuild{public static void Main() {#if (final)Console.WriteLine("Final Build");#elseConsole.WriteLine("Trial Build");#endif}}

　　如果用csc /define:final my.cs来编译就会显示"Final Build"，如果没有/define，编译后执行就会显示"Trial Build"。

　　十．/doc

　　文档在当今已经变得愈来愈重要了，一个好的程序应该配有相当的文档。如果你在写程序的文档中用的是"///"标识符来注释。当你使用/doc选项来编译时，你的所以注释文档将会自动的保留在一个XML文件中。

　　例子：以下是my.cs 的源程序

using System ;////// This is a sample class that has some documentation///public class myDocument {////// Main entry point of the class///public static void Main (string[] argv){Console.WriteLine("A Sample Class") ;}}

　　用下列编译语句会产生my.xml文件，看看my.xml文件到底存储了什么东西。

Csc /doc:my.xml my.cs

　　在默认情况下，编译产生的错误或者警告都只会指明发现错误的文件名称，加入此选项使得在编译器产生错误或者警告的时候会显示完整的路径。你可以把上面的my.cs程序语法搞错，再用 csc /fullpaths my.cs 和 csc my.cs分别编译，看看错误提示有什么不同。

　　十二./incremental

　　本选项主要是激活增量编译器，这种编译器只对上次编译后发生改变的函数进行编译。如果在编译时候选用了/debug选项，调试信息的状态存储在相应的.pdb文件中。除此编译时的信息都存储在.incr文件中，此.incr文件的名称为output_file_name.extension.incr。即如果输出文件时out.exe，则此文件对应的incr文件是out.exe.incr文件。

　　例子：利用增量编译器来编译文件

csc /incremental /out:my.exe my.cs

　　如果编译成功则会产生2个文件，分别是：my.exe和my.exe.incr。

　　十三./linkresource

　　这个选项就是在输出文件中创建到.Net资源的链接。他的简写是/linkres。资源文件就是在那些在工程文件中使用到的所有的资源，像图片、声音等。这个选项只是对于资源文件建立链接，这样有助于管理使用同一资源的程序，而不需要多个副本。此选项的具体语法如下：

/linkresource:filename,identifier,mimetype

　　其中：

　　filename:是想建立链接的.Net的资源文件

　　identifier(可选)：资源的逻辑名称，该名称用于载入资源，默认名称是文件名称。

　　mimetype(可选)：是一个代表资源的媒介类型的字符串。默认为空。

　　例子:在文件中建立一个指向reso.resource的链接

csc /linkres:reso.resource myResource.cs

　　十四./main

　　当我们编译二个或者多个拥有Main方法的Class，我们可以使用这个选项让用户指定最终的输出文件中的使用那个Main的方法。

　　例子：编译二个文件，但输出文件中的Main方法来自Main1 Class

csc myMain1.cs myMain2.cs /main:Main1

　　这个选项禁止在编译器启动时显示开始标志和编译过程中显示报告信息。

　　例子：

csc /noLogo my.cs

　　十六./nooutput

　　编译文件，但不创建任何输出文件。用户可以看到任何编译错误和警告。

　　例子：

csc /nooutput my.cs

　　十七./nostdlib

　　这个选项禁止导入mscorlib.dll。这个DLL包含了这个系统名称空间。当用户希望使用自己的系统名称空间时，一般才会使用此选项。

　　例子：编译文件，但不导入mscorlib.dl

csc /nooutput myOutput.cs

　　十八./nowarn

　　本选项是在编译过程中禁止指定的警告类型。如果是禁止多个警告类型，用逗号分隔。

　　例子：在编译过程中禁止警告类型CS0108和CS0109

csc /nowarn:108,109 Warn.cs

　　十九./optimize

　　本选项激活或者禁用由编译器执行优化。优化的结果是使得输出文件更小、更快、更有效率。缺省是/optimize执行优化，如果你选用了/optimize-则禁止优化。/o是/optimize的简写。

　　例子:编译文件，并禁止优化

csc /optimise- my.cs

　　二十./out

　　在没有指定输出文件的情况下，如果通过编译器编译后文件是EXE文件，则输出文件将从包含Main方法的源代码的文件中获得名字；如果编译后的文件是DLL文件，将从第一个源代码文件中获得名字。如果用户想要指定输出文件名称，就可以使用此选项。

　　例子：编译HelloWord.cs文件，并把输出文件命名为Hello.exe

csc /out:Hello.exe helloworld.cs

　　此选项允许用户编译在指定目录或者工程目录的所以子目录中的所有源代码文件。用户可以使用通配符来编译工程目录下的所有匹配文件。