常用的 MSBuild 项目项

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

公用项

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

Bb629388.collapse_all(zh-cn,VS.110).gif引用

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

项特性名称

描述

HintPath

可选字符串。 程序集的相对路径或绝对路径。

名称

可选字符串。 程序集的显示名称,例如“System.Windows.Forms”。

FusionName

可选字符串。 为该项指定简单合成名称或强合成名称。

如果此特性存在,则可节省时间,因为无需打开程序集文件即可获得合成名称。

SpecificVersion

可选布尔值。 指定是否只应引用合成名称中的版本。

Aliases

可选字符串。 引用的任意别名。

Private

可选布尔值。 指定是否应将引用复制到输出文件夹中。 此属性与在 Visual Studio IDE 中引用的 复制本地 属性。

Bb629388.collapse_all(zh-cn,VS.110).gifCOMReference

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

项特性名称

描述

名称

可选字符串。 组件的显示名称。

Guid

可选字符串。 组件的 GUID,形式为 {12345678-1234-1234-1234-1234567891234}。

VersionMajor

可选字符串。 组件版本号的主要部分。 例如,如果完整的版本号为“5.46”,则此属性值为“5”。

VersionMinor

可选字符串。 组件版本号的次要部分。 例如,如果完整的版本号为“5.46”,则此属性值为“46”。

LCID

可选字符串。 组件的 LocaleID。

WrapperTool

可选字符串。 组件中使用的包装工具的名称,例如“tlbimp”。

Isolated

可选布尔值。 指定组件是否是免注册组件。

Bb629388.collapse_all(zh-cn,VS.110).gifCOMFileReference

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

项特性名称

描述

WrapperTool

可选字符串。 组件中使用的包装工具的名称,例如“tlbimp”。

Bb629388.collapse_all(zh-cn,VS.110).gifNativeReference

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

项特性名称

描述

名称

必选的字符串。 清单文件的基名称。

HintPath

必选的字符串。 清单文件的相对路径。

Bb629388.collapse_all(zh-cn,VS.110).gifProjectReference

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

项特性名称

描述

名称

可选字符串。 引用的显示名称。

项目

可选字符串。 引用的 GUID,形式为 {12345678-1234-1234-1234-1234567891234}。

Package

可选字符串。 正在引用的项目文件的路径。

Bb629388.collapse_all(zh-cn,VS.110).gifCompile

表示编译器的源文件。

项特性名称

描述

DependentUpon

可选布尔值。 指示是否能正确编译该文件取决于另一个文件。

AutoGen

可选布尔值。 指示该文件是否由 Visual Studio 集成开发环境 (IDE) 为项目生成。

Link

可选字符串。 在文件实际位于项目文件影响的范围之外时要显示的表示法路径。

Visible

可选布尔值。 指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。

CopyToOutputDirectory

可选布尔值。 默认值 = false。 指定是否将文件复制到输出目录中。

Bb629388.collapse_all(zh-cn,VS.110).gifEmbeddedResource

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

项特性名称

描述

DependentUpon

可选布尔值。 指示是否能正确编译该文件取决于另一个文件。

生成器

必选的字符串。 在此项上运行的任何文件生成器的名称。

LastGenOutput

必选的字符串。 由在此项上运行的任何文件生成器创建的文件的名称。

CustomToolNamespace

必选的字符串。 在此项上运行的任何文件生成器在其中均应创建代码的命名空间。

Link

可选字符串。 如果文件实际位于项目影响的范围之外,则显示表示法路径。

Visible

可选布尔值。 指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。

CopyToOutputDirectory

可选布尔值。 默认值 = false。 指定是否将文件复制到输出目录中。

LogicalName

必选的字符串。 嵌入资源的逻辑名称。

Bb629388.collapse_all(zh-cn,VS.110).gif内容

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

项特性名称

描述

DependentUpon

可选布尔值。 指示是否能正确嵌入或发布该文件取决于另一个文件。

生成器

必选的字符串。 在此项上运行的任何文件生成器的名称。

LastGenOutput

必选的字符串。 由在此项上运行的任何文件生成器创建的文件的名称。

CustomToolNamespace

必选的字符串。 在此项上运行的任何文件生成器在其中均应创建代码的命名空间。

Link

可选布尔值。 指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。

PublishState

必选的字符串。 内容的发布状态,可为:

  • 默认

  • 包括

  • 排除

  • DataFile

  • 系统必备

IsAssembly

可选布尔值。 指定文件是否为程序集。

Visible

可选布尔值。 指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。

CopyToOutputDirectory

可选布尔值。 默认值 = false。 指定是否将文件复制到输出目录中。

Bb629388.collapse_all(zh-cn,VS.110).gif

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

项特性名称

描述

DependentUpon

可选布尔值。 指示是否能正确嵌入或发布该文件取决于另一个文件。

生成器

必选的字符串。 在此项上运行的任何文件生成器的名称。

LastGenOutput

必选的字符串。 由在此项上运行的任何文件生成器创建的文件的名称。

CustomToolNamespace

必选的字符串。 在此项上运行的任何文件生成器在其中均应创建代码的命名空间。

Link

可选字符串。 如果文件实际位于项目影响的范围之外,则显示表示法路径。

Visible

可选布尔值。 指示是否在 Visual Studio 的“解决方案资源管理器”中显示文件。

CopyToOutputDirectory

可选布尔值。 默认值 = false。 指定是否将文件复制到输出目录中。

Bb629388.collapse_all(zh-cn,VS.110).gifBaseApplicationManifest

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

Bb629388.collapse_all(zh-cn,VS.110).gifCodeAnalysisImport

表示要导入的 FxCop 项目。

Bb629388.collapse_all(zh-cn,VS.110).gif导入

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

请参见

参考

常用的 MSBuild 项目属性