C#编译器命令行参数

Microsoft(R) Visual C# 2010 编译器 4.0.30319.1 版
版权所有(C) Microsoft Corporation。保留所有权利。

                        Visual C# 2010 编译器选项

                        - 输出文件 -
/out:<文件>                    指定输出文件名(默认值: 包含主类的文件或第一个文件的基名称)
/target:exe                    生成控制台可执行文件(默认) (缩写: /t:exe)
/target:winexe                 生成 Windows 可执行文件 (缩写: /t:winexe)
/target:library                生成库 (缩写: /t:library)
/target:module                 生成能添加到其他程序集的模块 (缩写: /t:module)
/delaysign[+|-]                仅使用强名称密钥的公共部分对程序集进行延迟签名
/doc:<文件>                    要生成的 XML 文档文件
/keyfile:<文件>                指定强名称密钥文件
/keycontainer:<字符串>         指定强名称密钥容器
/platform:<字符串>             限制可以在其上运行此代码的平台: x86、Itanium、x64 或 anycpu。默认值为 anycpu。

                        - 输入文件 -
/recurse:<通配符>              根据通配符规范，包括当前目录和子目录下的所有文件
/reference:<别名>=<文件>       使用给定的别名从指定的程序集文件引用元数据 (缩写: /r)
/reference:<文件列表>          从指定的程序集文件引用元数据 (缩写: /r)
/addmodule:<文件列表>          将指定的模块链接到此程序集中
/link:<文件列表>               嵌入指定的互操作程序集文件中的元数据 (缩写: /l)

                        - 资源 -
/win32res:<文件>               指定 Win32 资源文件(.res)
/win32icon:<文件>              对输出使用此图标
/win32manifest:<文件>          指定 Win32 清单文件(.xml)
/nowin32manifest               不包括默认 Win32 清单
/resource:<资源信息>           嵌入指定的资源 (缩写: /res)
/linkresource:<资源信息>       将指定的资源链接到此程序集 (缩写: /linkres)
                               其中 resinfo 的格式是 <file>[,<string name>[,public|private]]

                        - 代码生成 -
/debug[+|-]                    发出调试信息
/debug:{full|pdbonly}          指定调试类型(“full”是默认类型，可以将调试程序附加到正在运行的程序)
/optimize[+|-]                 启用优化 (缩写: /o)

                        - 错误和警告 -
/warnaserror[+|-]              将所有警告报告为错误
/warnaserror[+|-]:<警告列表>   将特定警告报告为错误
/warn:<n>                      设置警告等级(0-4) (缩写: /w)
/nowarn:<警告列表>             禁用特定的警告消息

                        - 语言 -
/checked[+|-]                  生成溢出检查
/unsafe[+|-]                   允许“不安全”代码
/define:<符号列表>             定义条件编译符号 (缩写: /d)
/langversion:<字符串>          指定语言版本模式: ISO-1、ISO-2、3 或 Default

                        - 杂项 -
@<文件>                        有关更多选项，请阅读响应文件
/help                          显示此用法信息 (缩写: /?)
/nologo                        取消编译器版权信息
/noconfig                      不要自动包含 CSC.RSP 文件

                        - 高级 -
/baseaddress:<地址>            要生成的库的基址
/bugreport:<文件>              创建“Bug 报告”文件
/codepage:<n>                  指定打开源文件时要使用的代码页
/utf8output                    以 UTF-8 编码格式输出编译器消息
/main:<类型>                   指定包含入口点的类型(忽略所有其他可能的入口点) (缩写: /m)
/fullpaths                     编译器生成完全限定路径
/filealign:<n>                 指定用于输出文件节的对齐方式
/pdb:<文件>                    指定调试信息文件名(默认值: 扩展名为 .pdb 的输出文件名)
/nostdlib[+|-]                 不引用标准库(mscorlib.dll)
/lib:<文件列表>                指定要在其中搜索引用的附加目录
/errorreport:<字符串>          指定如何处理内部编译器错误: prompt、send、queue 或 none。默认值为 queue。
/appconfig:<文件>              指定一个包含程序集绑定设置的应用程序配置文件
/moduleassemblyname:<字符串>   此模块所属程序集的名称

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

csc.exe是microsoft .NET framework下的c#编译器：

1.配置C#命令行编译器:

我的 电脑 —〉高级　—〉环境变量　—〉Path —〉添加";C:\Windows\Microsoft.NET\Framework\v2.0.50727"(Path的最后一个路径虽版本的改变而改 变)。csc.exe(C#命令行编译器)就放在该目录下。通过csc /?来查看所有参数。

2.配置其它.NET命令行工具

我 的电脑 —〉高级　—〉环境变量　—〉Path —〉添加";D:\ProgramFiles\Microsoft Visual Studio 8\SDK\v2.0\Bin"(Path随安装目录的改变而改变，如果安装在C:\，则为";C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin"

3.命令行基础知识
如果您使用命令行的次数很有限，那么请让我说明一些基本的详细信息，以便进行必要的准备。

首先，可以使用反斜杠或单个短划线指定 csc.exe 的选项。其次，在 / 或 - 以及随后的标志之间具有额外的空格是非法的。因此，“-help”是完全正确，而“- help”就行不通了。为了加以说明，让我们使用 help 标志检查完整的命令行选项集：

csc –help
csc /help

如果一切正常，则您应当看到所有可能的标志.

很多选项都提供了简写表示法，以便为您节省一些键入时间。假设 help 标志的简写表示法是 ?，则您可以如下所示列出 csc.exe 的选项：

csc –?
csc /?

很多选项都需要附加的修饰，例如，目录路径和文件名。这种性质的标志使用冒号将标志与它的修饰分隔开来。例如，/reference 选项要求将 .NET 程序集的名称包括在程序集清单中：

csc /reference:MyLibrary.dll ...

其他标志在性质上是二元 的，因为它们或者被启用 (+)，或者被禁用 (-)。二元标志总是默认为它们的禁用状态，因此您通常只需要使用加号标记。例如，要将所有编译警告都视为错误，可以启用 warnaserror 标志：

csc /warnaserror+ ...

标 志的顺序无关紧要，但是在指定输入文件集合之前，必须列出所有标志的集合。另外值得说明的是，在修饰和它的关联数据之间具有额外的空格是非法的。例如，请 使用 /reference:MyLibrary.dll，而不要使用 /reference:MyLibrary.dll。

4.C#命令行编译器的常用选项

(1)/addmodule

指定要在所创建程序集中包含的模块，这是一种创建多文件程序集的简便方法。

(2)/debug

允许生成调试信息。

(3)/define

   预处理器指令能直接传给编译器：/define:DEBUG

(4)/delaysign

   使用强名的延迟签名构建程序集。

(5)/doc

   指定要生成一个包含XML文档的输出文件。

(6)/keyfile

   指定.snk文件的路径，该文件中包含用于强签名的密钥对。

(7)/lib

   指定/reference选项中包含的程序集所在的位置。

(8)/out

   编译所得输出文件的文件名，默认为输入文件名加.exe后缀。

(9)/reference(简写/r)

   引用一个外部程序集。

(10)/resource

   将资源文件嵌入到创建的程序集中。

(11)/target(简写/t)

   指定所创建输出文件的类型：

   /t:exe 构建*.exe控制台应用，这是默认输出

   /t:library 构建*.dll程序集

   /t:module 构建不包含清单的模块(可移植的可执行文件，PE)

   /t:winexe 构建*.exe Windows窗体程序集

使用原始编译器的真正意义是，可以同时处理多个文件和程序。

例：有两个C#源文件，client.cs和clientlib.cs

ⅰ：编译多个文件：

C#编译器接受多个输入源文件，并将输出合并为一个程序集

csc /out:client.exe client.cs clientlib.cs

ⅱ：创建和使用代码库

Clientlib中的代码可以放入一个单独的库中，这个库可以由所有客户访问

csc /t:library clientlib.cs

输出是一个名为clientlib.dll的程序集，编译客户代码，并引用这个外部程序集：

csc /r:clientlib.dll client.cs

输出是一个名为client.exe的程序集，如果使用Ildasm查看，可以看到单中包含有对lientlib程序集的引用。

ⅲ：创建多文件程序集

   与作为一个单独的程序集相比，更好的方式是将clientlib作为一个单独的文件打包到client.exe程序集中。由于程序集中只有一个包含清单的 文件，所以首先要将clientlib.cs编译为可移植的可执行模块。为此，要将输出目标设置为module：

   csc /t:module clientlib.cs

输出文件是clientlib.netmodule。使用编译器的addmodule选项将它添加到client.exe程序集：

   csc /addmodule:clientlib.netmodule client.cs

最后得到的程序集包含两个文件：client.exe和clientlib.netmodule.