把类型编译成一个模块
先假设有这么一个简单的程序:
public sealed class Program
{
public static void Main()
{
System.Console.WriteLine("Hi");
}
}
该程序定义一个名为 Program 的类型,它拥有一个公有静态 (public, static) 方法 Main,该方法参照 System.Console。把源代码存为 Program.cs 执行以下命令行:
csc.exe /out:Program.exe /t:exe /r:MSCorLib.dll Program.cs
该命令行有以下功能:
- 让 C# 编译器生成一可执行文件(/out:Program.exe)
- 文件类型为Win32控制台程序(/t[arget]:exe)
- 指示参照类型的程序集(/r:MSCorLib.dll),由于MSCorLib.dll 总被C# 编译器默认参照,所以可省略。特殊情况下(比如Microsoft 在编译MSCorLib.dll 本身时)用/nostdlib命令开关来取消默认参照
响应文件(Response file)
响应文件包含了一系列编译器的命令行开关,调用CSC.exe 时通过一个 @ 符号来告诉编译器使用指定的响应文件。例如:有一个名为 MyProject.rsp 并包含以下内容的响应文件。
/out:MyProject.exe
/target:winexe
使用以下命令告诉 CSC.exe 来使用这个文件:
csc.exe @MyProject.rsp CodeFile1.cs CodeFile2.cs
C# 编译器支持多个响应文件,除了你在命令行中指定的文件,编译器还自动查找 CSC.rsp(作为全局设定),一些需要适用到所有工程的设定可以写在这个文件中。如果同时存在互相矛盾的设定,那么本地设定比全局设定有更高的优先级,与此类似的是直接通过命令行指定的设定优先级比本地设定要高。
当你安装 .NET Framework 时,一个全局的 CSC.rsp 文件被安装到 %SystemRoot%\Microsoft.NET\Framework(64)\vX.X.X 目录 (X.X.X 为.NET Framework 版本号)。通常这个文件包含以下内容:
# This file contains command-line options that the C#
# command line compiler (CSC) will process as part
# of every compilation, unless the "/noconfig" option
# is specified.
# Reference the common Framework libraries
/r:Accessibility.dll
/r:Microsoft.CSharp.dll
/r:System.Configuration.dll
/r:System.Configuration.Install.dll
/r:System.Core.dll
/r:System.Data.dll
/r:System.Data.DataSetExtensions.dll
/r:System.Data.Linq.dll
/r:System.Data.OracleClient.dll
/r:System.Deployment.dll
/r:System.Design.dll
/r:System.DirectoryServices.dll
/r:System.dll
/r:System.Drawing.Design.dll
/r:System.Drawing.dll
/r:System.EnterpriseServices.dll
/r:System.Management.dll
/r:System.Messaging.dll
/r:System.Runtime.Remoting.dll
/r:System.Runtime.Serialization.dll
/r:System.Runtime.Serialization.Formatters.Soap.dll
/r:System.Security.dll
/r:System.ServiceModel.dll
/r:System.ServiceModel.Web.dll
/r:System.ServiceProcess.dll
/r:System.Transactions.dll
/r:System.Web.dll
/r:System.Web.Extensions.Design.dll
/r:System.Web.Extensions.dll
/r:System.Web.Mobile.dll
/r:System.Web.RegularExpressions.dll
/r:System.Web.Services.dll
/r:System.Windows.Forms.Dll
/r:System.Workflow.Activities.dll
/r:System.Workflow.ComponentModel.dll
/r:System.Workflow.Runtime.dll
/r:System.Xml.dll
/r:System.Xml.Linq.dll
由于全局 CSC.rsp 文件参照了以上所有程序集,所以大多数编译情况下你不需要使用 /reference 开关就能使用 Microsoft 开发的程序集。
提示:当你使用 /reference 编译开关时,你可以通过完整的路径来指定一个文件。而当你没有指定完整的路径,编译器会依次搜索以下目录:
■ 工作目录(Working directory)
■ CSC.exe 所在目录。MSCorLib.dll 总在这个目录中,默认路径: %SystemRoot%\Microsoft.NET\Framework\v4.0.#####.
■ 通过 /lib 编译器开关指定的目录
■ LIB 环境变量制定的目录
最后如果想无视本地/全局响应文件,只需在编译命令行中使用 /noconfig 命令行。