常用的 MSBuild 项目项

2013-02-21

在 MSBuild 中，项是对一个或多个文件的命名引用。包含文件名、路径和版本号等元数据的项。Visual Studio 中的所有项目类型都有几个公用项。这些项在文件 microsoft.build.commontypes.xsd 中定义。

公用项

下面列出了所有的公用项目项。

引用

表示项目中的一个程序集（托管）引用。

项特性名称	描述
HintPath	可选字符串。程序集的相对路径或绝对路径。
名称	可选字符串。程序集的显示名称，例如“System.Windows.Forms”。
FusionName	可选字符串。为该项指定简单合成名称或强合成名称。如果此特性存在，则可节省时间，因为无需打开程序集文件即可获得合成名称。
SpecificVersion	可选布尔值。指定是否只应引用合成名称中的版本。
Aliases	可选字符串。引用的任意别名。
Private	可选布尔值。指定是否应将引用复制到输出文件夹中。此属性与在 Visual Studio IDE 中引用的复制本地属性。

COMReference

表示项目中的一个 COM（非托管）组件引用。

项特性名称	描述
名称	可选字符串。组件的显示名称。
Guid	可选字符串。组件的 GUID，形式为 {12345678-1234-1234-1234-1234567891234}。
VersionMajor	可选字符串。组件版本号的主要部分。例如，如果完整的版本号为“5.46”，则此属性值为“5”。
VersionMinor	可选字符串。组件版本号的次要部分。例如，如果完整的版本号为“5.46”，则此属性值为“46”。
LCID	可选字符串。组件的 LocaleID。
WrapperTool	可选字符串。组件中使用的包装工具的名称，例如“tlbimp”。
Isolated	可选布尔值。指定组件是否是免注册组件。

COMFileReference

表示填入 ResolvedComreference 目标的类型库的列表。

项特性名称	描述
WrapperTool	可选字符串。组件中使用的包装工具的名称，例如“tlbimp”。

NativeReference

表示本机清单文件或对此类文件的引用。

项特性名称	描述
名称	必选的字符串。清单文件的基名称。
HintPath	必选的字符串。清单文件的相对路径。

ProjectReference

表示对另一个项目的引用。

项特性名称	描述
名称	可选字符串。引用的显示名称。
项目	可选字符串。引用的 GUID，形式为 {12345678-1234-1234-1234-1234567891234}。
Package	可选字符串。正在引用的项目文件的路径。

Compile

表示编译器的源文件。

项特性名称	描述
DependentUpon	可选布尔值。指示是否能正确编译该文件取决于另一个文件。
AutoGen	可选布尔值。指示该文件是否由 Visual Studio 集成开发环境 (IDE) 为项目生成。
Link	可选字符串。在文件实际位于项目文件影响的范围之外时要显示的表示法路径。
Visible	可选布尔值。指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选布尔值。默认值 = false。指定是否将文件复制到输出目录中。

EmbeddedResource

表示要嵌入所生成的程序集中的资源。

项特性名称	描述
DependentUpon	可选布尔值。指示是否能正确编译该文件取决于另一个文件。
生成器	必选的字符串。在此项上运行的任何文件生成器的名称。
LastGenOutput	必选的字符串。由在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace	必选的字符串。在此项上运行的任何文件生成器在其中均应创建代码的命名空间。
Link	可选字符串。如果文件实际位于项目影响的范围之外，则显示表示法路径。
Visible	可选布尔值。指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选布尔值。默认值 = false。指定是否将文件复制到输出目录中。
LogicalName	必选的字符串。嵌入资源的逻辑名称。

内容

表示未编译到项目中但可能嵌入项目或随其一起发布的文件。

项特性名称	描述
DependentUpon	可选布尔值。指示是否能正确嵌入或发布该文件取决于另一个文件。
生成器	必选的字符串。在此项上运行的任何文件生成器的名称。
LastGenOutput	必选的字符串。由在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace	必选的字符串。在此项上运行的任何文件生成器在其中均应创建代码的命名空间。
Link	可选布尔值。指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。
PublishState	必选的字符串。内容的发布状态，可为：默认包括排除 DataFile 系统必备
IsAssembly	可选布尔值。指定文件是否为程序集。
Visible	可选布尔值。指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选布尔值。默认值 = false。指定是否将文件复制到输出目录中。

无

表示在生成过程中不应具有角色的文件。

项特性名称	描述
DependentUpon	可选布尔值。指示是否能正确嵌入或发布该文件取决于另一个文件。
生成器	必选的字符串。在此项上运行的任何文件生成器的名称。
LastGenOutput	必选的字符串。由在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace	必选的字符串。在此项上运行的任何文件生成器在其中均应创建代码的命名空间。
Link	可选字符串。如果文件实际位于项目影响的范围之外，则显示表示法路径。
Visible	可选布尔值。指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选布尔值。默认值 = false。指定是否将文件复制到输出目录中。

BaseApplicationManifest

表示生成的基本应用程序清单，并包含 ClickOnce 部署安全信息。

CodeAnalysisImport

表示要导入的 FxCop 项目。

导入

表示应由 Visual Basic 编译器导入其命名空间的程序集。

请参见

参考

常用的 MSBuild 项目属性

通过