MSBuild 项目文件架构参考

提供所有 MSBuild XML 架构元素及其可用属性和子元素的表。

MSBuild 使用项目文件来指示生成引擎要生成的内容以及如何生成它。 MSBuild 项目文件是符合 MSBuild XML 架构的 XML 文件。 本部分记录 MSBuild 的 XML 架构定义 (.xsd) 文件。

MSBuild XSD 架构定义文件

Visual Studio 2017 及更高版本中不需要 MSBuild 项目文件中的架构链接。 如果存在,则 http://schemas.microsoft.com/developer/msbuild/2003 不管 Visual Studio 的版本如何。 此值不是实时 Web 目标;可在 Microsoft.Build.xsd 中找到最新的 MSBuild 架构定义文件(.xsd文件)。

下表显示了指向 XSD 架构的每个版本的链接:

MSBuild 版本 GitHub 链接 原始链接(用于工具)
17.14 Microsoft.Build.xsd 版本 17.14.13
17.13 Microsoft.Build.xsd 版本 17.13.26
17.12 Microsoft.Build.xsd 版本 17.12.41
17.11 Microsoft.Build.xsd 版本 17.11.31
17.10 Microsoft.Build.xsd 版本 17.10.29
17.9 Microsoft.Build.xsd 版本 17.9.8
17.8 Microsoft.Build.xsd 版本 17.8.32
17.7 Microsoft.Build.xsd 版本 17.7.4
17.6 Microsoft.Build.xsd 版本 17.6.11
17.5 Microsoft.Build.xsd 版本 17.5.1
17.4 Microsoft.Build.xsd 版本 17.4.4
17.3 Microsoft.Build.xsd 版本 17.3.1
17.2 Microsoft.Build.xsd 版本 17.2.1
17.1 Microsoft.Build.xsd 版本 17.1.1
17.0 Microsoft.Build.xsd 版本 17.0.0
16.11 Microsoft.Build.xsd 版本 16.11.2
16.10 Microsoft.Build.xsd 版本 16.10.2
16.9 Microsoft.Build.xsd 版本 16.9.2
16.8 Microsoft.Build.xsd 版本 16.8.3
16.7 Microsoft.Build.xsd 版本 16.7.0.37604
16.4 Microsoft.Build.xsd 版本 16.4.0.56107
15.9 Microsoft.Build.xsd 版本 15.9.21.664

顶级 XSD 文件包括另外两个子 XSD 文件, Microsoft.Build.CommonTypes.xsdMicrosoft.Build.Core.xsd。 还可以在 Xml\Schemas\1033\MSBuild 下的 Visual Studio 安装文件夹中找到所有 MSBuild XSD 架构定义文件。

有关 MSBuild 版本的详细信息,包括相应的 .NET SDK 版本的表,请参阅 .NET、MSBuild 和 Visual Studio 版本控制概述

MSBuild XML 架构元素

下表列出了所有 MSBuild XML 架构元素及其子元素和属性。

元素 子元素 Attributes
Choose 元素 (MSBuild) 否则

什么时候
--
Import 元素 (MSBuild) -- Condition

项目
ImportGroup 元素 Import Condition
Item 元素 (MSBuild) ItemMetaData Condition

排除

包括

Remove
ItemDefinitionGroup 元素 (MSBuild) 物品 Condition
ItemGroup 元素 (MSBuild) 物品 Condition
ItemMetadata 元素 (MSBuild) 物品 Condition
OnError 元素 (MSBuild) -- Condition

ExecuteTargets
否则元素 (MSBuild) 选择

ItemGroup

PropertyGroup
--
Output 元素 (MSBuild) -- Condition

ItemName

PropertyName

TaskParameter
Parameter 元素 -- 输出

ParameterType

必选
ParameterGroup 元素 参数 --
Project 元素 (MSBuild) 选择

Import

ItemGroup

ProjectExtensions

PropertyGroup

Target

UsingTask
DefaultTargets

InitialTargets

Sdk

ToolsVersion

TreatAsLocalProperty

xmlns
ProjectExtensions 元素 (MSBuild) -- --
Property 元素 (MSBuild) -- Condition
PropertyGroup 元素 (MSBuild) 属性 Condition
Sdk 元素 (MSBuild) -- Name

版本
目标元素 (MSBuild) OnError

任务
AfterTargets

BeforeTargets

Condition

DependsOnTargets

输入

KeepDuplicateOutputs

Name

输出

退货
Target 的任务元素(MSBuild) 输出 Condition

ContinueOnError

参数
UsingTask 的任务元素(MSBuild) 数据 Evaluate
UsingTask 元素 (MSBuild) ParameterGroup

任务
AssemblyFile

AssemblyName

Condition

TaskFactory

TaskName
When 元素 (MSBuild) 选择

ItemGroup

PropertyGroup
Condition

另请参阅