常用的 MSBuild 项目项

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

本文列出了所有常见项目项。

参考

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

项元数据名称 描述
HintPath 可选的字符串。 程序集的相对或绝对路径。
“属性” 可选的字符串。 程序集的显示名称,例如“System.Windows.Forms”。
FusionName 可选的字符串。 指定项的简单或强合成名称。

当此属性存在时,它可能会节省时间,因为无需打开程序集文件即可获取融合名称。
SpecificVersion 可选的布尔值。 指定是否应仅引用合成名称中的版本。
别名 可选的字符串。 引用的任何别名。
Private 可选的布尔值。 指定是否应将引用复制到输出文件夹。 此特性与 Visual Studio IDE 中的引用的“复制本地”属性相匹配。

COMReference

表示项目中的 COM(非托管)组件引用。 此项仅适用于 .NET 项目。

项元数据名称 描述
“属性” 可选的字符串。 组件的显示名称。
GUID 必选字符串。 组件的 GUID,形式为 {12345678-1234-1234-1234-123456781234}。
VersionMajor 必选字符串。 组件版本号的主要部分。 例如,如果完整版本号是“5.46”,则显示“5”。
VersionMinor 必选字符串。 组件版本号的次要部分。 例如,如果完整版本号是“5.46”,则显示“46”。
EmbedInteropTypes 可选的布尔值。 如果为 true,则将此引用中的互操作类型直接嵌入到程序集中,而不是生成互操作 DLL。
Lcid 可选的字符串。 组件的 LocaleID。
WrapperTool 可选的字符串。 对组件使用的包装器的名称。 值为:

1. primary
2. tlbimp
3. primaryortlbimp
4. aximp
Isolated 可选的布尔值。 指定组件是否为免注册组件。

COMFileReference

表示传递到 ResolveComReference 目标的 TypeLibFiles 参数的类型库的列表。 此项仅适用于 .NET 项目。

项元数据名称 描述
WrapperTool 可选的字符串。 对组件使用的包装器的名称。 值为:

1. primary
2. tlbimp
3. primaryortlbimp
4. aximp

NativeReference

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

项元数据名称 描述
“属性” 必选字符串。 清单文件基名称。
HintPath 必选字符串。 清单文件的相对路径。

ProjectReference

表示对另一个项目的引用。 ProjectReference 项由 ResolveProjectReferences 目标转换为 Reference 项,因此,如果转换过程没有将其覆盖,则 Reference 上的任何有效元数据都可能在 ProjectReference 上有效。

项元数据名称 描述
“属性” 可选的字符串。 引用的显示名称。
GlobalPropertiesToRemove 可选的 string[]。 在生成引用项目时要删除的属性的名称,例如 RuntimeIdentifier;PackOnBuild。 默认为空。
项目 可选的字符串。 引用的 GUID,形式为 {12345678-1234-1234-1234-123456781234}。
OutputItemType 可选的字符串。 要将目标输出发到的项类型。 默认为空。 如果引用元数据设置为“true”(默认值),则目标输出将成为编译器的引用。
ReferenceOutputAssembly 可选的布尔值。 如果设置为 false,则不包括引用项目的输出作为 此项目的引用 ,但仍确保另一个项目在此项目之前生成。 默认为 true
Private 可选的布尔值。 指定是否应将引用复制到输出文件夹。 此特性与 Visual Studio IDE 中的引用的“复制本地”属性相匹配。
SetConfiguration 可选的字符串。 为引用的项目设置全局属性 Configuration,例如 Configuration=Release
SetPlatform 可选的字符串。 为引用的项目设置全局属性 Platform,例如 Platform=AnyCPU
SetTargetFramework 可选的字符串。 为引用的项目设置全局属性 TargetFramework,例如 TargetFramework=netstandard2.0
SkipGetTargetFrameworkProperties 可选的布尔值。 如果为 true,则在不协商最兼容的 TargetFramework 值的情况下生成引用的项目。 默认为 false
目标 可选的 string[]。 应生成的引用项目中的目标的列表,以分号分隔。 默认值为 $(ProjectReferenceBuildTargets)默认值,该值默认为空,指示默认目标。 在 Visual Studio(而不是 MSBuild.exedotnet build)中生成时,指定这不会阻止 Visual Studio 生成引用项目的默认目标。

注意

项目引用在 .NET Framework 与 .NET Core(包括 .NET 5 及更高版本)之间的工作方式存在差异。 在 .NET Framework 项目中,项目引用不可传递。 也就是说,如果 Project1 引用 Project2,而 Project2 引用 Project3,你就无法从 Project1 对 Project3 进行编码。 但是,在 .NET Core(包含 .NET 5 及更高版本)中,项目引用是可传递的。 可以在 Project1 中对 Project3 进行编码。

Compile

表示编译器的源文件。

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

1. Never
2. Always
3. PreserveNewest

EmbeddedResource

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

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

1. Never
2. Always
3. PreserveNewest
LogicalName 必选字符串。 嵌入资源的逻辑名称。

内容

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

项元数据名称 描述
DependentUpon 可选的字符串。 指定该文件正确编译所依赖的文件。
Generator 可选的字符串。 在此项上运行的任何文件生成器的名称。
LastGenOutput 可选的字符串。 在此项上运行的任何文件生成器创建的文件的名称。
CustomToolNamespace 可选的字符串。 在此项上运行的任何文件生成器应在其中创建代码的命名空间。
链接 可选的字符串。 文件在物理上处于项目的影响范围之外时要显示的符号路径。
PublishState 必选字符串。 内容的发布状态,为以下任一项:

- Default
- Included
- Excluded
- DataFile
- Prerequisite
IsAssembly 可选的布尔值。 指定文件是否为程序集。
可见 可选的布尔值。 指示是否要在 Visual Studio 中的“解决方案资源管理器”中显示文件。
CopyToOutputDirectory 可选的字符串。 确定是否将文件复制到输出目录。 值为:

1. Never
2. Always
3. PreserveNewest
TargetPath 可选的字符串。 项的输出路径(相对于配置和/或平台特定的输出目录),包括文件名。 这遵循 Link 元数据(如果提供)。 如果未提供 TargetPath,则会在生成过程中计算它。 请参阅 AssignTargetPath

None

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

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

1. Never
2. Always
3. PreserveNewest

AssemblyMetadata

表示要生成为 [AssemblyMetadata(key, value)] 的程序集特性。

项元数据名称 描述
包括 成为 AssemblyMetadataAttribute 特性构造函数中的第一个参数(键)。
“值” 必选字符串。 成为 AssemblyMetadataAttribute 特性构造函数中的第二个参数(值)。

注意

此项适用于使用 SDK for .NET 5(和 .NET Core)及更高版本的项目。

InternalsVisibleTo

指定要作为 [InternalsVisibleTo(..)] 程序集特性发出的程序集。

项元数据名称 描述
包括 程序集名称。
Key 可选的字符串。 程序集的公钥。

注意

此项适用于使用 SDK for .NET 5(和 .NET Core)及更高版本的项目。

BaseApplicationManifest

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

CodeAnalysisImport

表示要导入的 FxCop 项目。

导入

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

文件夹

此元素仅由 Visual Studio 用作空文件夹的占位符。 填充文件夹后,该文件夹将被另一个元素替换。

另请参阅