常用的 MSBuild 项目项

项目
06/09/2015

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

通用项

以下是所有通用项目项的列表。

参考

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

项名称	描述
HintPath	可选的字符串。程序集的相对或绝对路径。
名称	可选的字符串。程序集的显示名称，例如“System.Windows.Forms”。
FusionName	可选的字符串。指定项的简单或强合成名称。此特性存在时，可以节省时间，因为程序集文件不必打开即可获取合成名称。
SpecificVersion	可选的布尔值。指定是否应仅引用合成名称中的版本。
别名	可选的字符串。引用的任何别名。
Private	可选的字符串。确定是否将文件复制到输出目录。值为： Never Always PreserveNewest

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

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

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

Compile

表示编译器的源文件。

项名称	描述
DependentUpon	可选的字符串。指定该文件正确编译所依赖的文件。
AutoGen	可选的布尔值。指示是否已由 Visual Studio 集成开发环境 (IDE) 为项目生成了文件。
Link	可选的字符串。文件在物理上处于项目文件的影响范围之外时要显示的符号路径。
可见	可选的布尔值。指示是否要在 Visual Studio 中的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选的字符串。确定是否将文件复制到输出目录。值为： Never Always PreserveNewest

EmbeddedResource

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

项名称	描述
DependentUpon	可选的字符串。指定该文件正确编译所依赖的文件。
Generator	必选字符串。在此项上运行的任何文件生成器的名称。
LastGenOutput	必选字符串。在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace	必选字符串。在此项上运行的任何文件生成器应在其中创建代码的命名空间。
Link	可选的字符串。如果文件在物理上处于项目的影响范围之外，则显示符号路径。
可见	可选的布尔值。指示是否要在 Visual Studio 中的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选的字符串。确定是否将文件复制到输出目录。值为： Never Always PreserveNewest
LogicalName	必选字符串。嵌入资源的逻辑名称。

内容

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

项名称	描述
DependentUpon	可选的字符串。指定该文件正确编译所依赖的文件。
Generator	必选字符串。在此项上运行的任何文件生成器的名称。
LastGenOutput	必选字符串。在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace	必选字符串。在此项上运行的任何文件生成器应在其中创建代码的命名空间。
Link	可选的布尔值。指示是否要在 Visual Studio 中的“解决方案资源管理器”中显示文件。
PublishState	必选字符串。内容的发布状态，为以下任一项：默认 Included Excluded DataFile 必备组件
IsAssembly	可选的布尔值。指定文件是否为程序集。
可见	可选的布尔值。指示是否要在 Visual Studio 中的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选的字符串。确定是否将文件复制到输出目录。值为： Never Always PreserveNewest

无

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

项名称	描述
DependentUpon	可选的字符串。指定该文件正确编译所依赖的文件。
Generator	必选字符串。在此项上运行的任何文件生成器的名称。
LastGenOutput	必选字符串。在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace	必选字符串。在此项上运行的任何文件生成器应在其中创建代码的命名空间。
Link	可选的字符串。文件在物理上处于项目的影响范围之外时要显示的符号路径。
可见	可选的布尔值。指示是否要在 Visual Studio 中的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory	可选的字符串。确定是否将文件复制到输出目录。值为： Never Always PreserveNewest

BaseApplicationManifest

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

CodeAnalysisImport

表示要导入的 FxCop 项目。

导入

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

请参见

参考

常用的 MSBuild 项目属性

通过