MSBuild 项目文件架构引用
提供列有所有 MSBuild XML 架构元素及其可用属性和子元素的表。
MSBuild 使用项目文件指示生成引擎要生成哪些内容以及生成方法。 MSBuild 项目文件是 XML 文件，其遵循 MSBuild XML 架构。 本部分介绍 MSBuild 的 XML 架构定义 (.xsd) 文件。
MSBuild XSD 架构定义文件
Visual Studio 2017 和更高版本不需要 MSBuild 项目文件中的架构链接。 如果该链接存在，则无论 Visual Studio 的版本如何，它都应为 http://schemas.microsoft.com/developer/msbuild/2003。 此值不是实时 Web 目标，可以在 Microsoft.Build.xsd 中找到最新的 MSBuild 架构定义文件（.xsd 文件）。
下表显示了指向 XSD 架构的每个版本的链接：
| MSBuild 版本 | GitHub 链接 | 原始链接（工具） |
|---|---|---|
| 17.7 | Microsoft.Build.xsd 版本 17.7.0 | raw |
| 17.6 | Microsoft.Build.xsd 版本 17.6.3 | raw |
| 17.5 | Microsoft.Build.xsd 版本 17.5.1 | raw |
| 17.4 | Microsoft.Build.xsd 版本 17.4.4 | raw |
| 17.3 | Microsoft.Build.xsd 版本 17.3.1 | raw |
| 17.2 | Microsoft.Build.xsd 版本 17.2.1 | raw |
| 17.1 | Microsoft.Build.xsd 版本 17.1.1 | raw |
| 17.0 | Microsoft.Build.xsd 版本 17.0.0 | raw |
| 16.11 | Microsoft.Build.xsd 版本 16.11.2 | raw |
| 16.10 | Microsoft.Build.xsd 版本 16.10.2 | raw |
| 16.9 | Microsoft.Build.xsd 版本 16.9.2 | raw |
| 16.8 | Microsoft.Build.xsd 版本 16.8.3 | raw |
| 16.7 | Microsoft.Build.xsd 版本 16.7.0.37604 | raw |
| 16.4 | Microsoft.Build.xsd 版本 16.4.0.56107 | raw |
| 15.9 | Microsoft.Build.xsd 版本 15.9.21.664 | raw |
顶级 XSD 文件包含另外两个子级 XSD 文件：Microsoft.Build.CommonTypes.xsd 和 Microsoft.Build.Core.xsd。 还可以在 Visual Studio 安装文件夹的 Xml\Schemas\1033\MSBuild 下找到所有 MSBuild XSD 架构定义文件。
有关 MSBuild 版本的详细信息（包括对应 .NET SDK 版本的表），请参阅 .NET、MSBuild 和 Visual Studio 版本控制概述。
MSBuild XML 架构元素
下表列出了所有 MSBuild XML 架构元素及其子元素和属性。
| 元素 | 子元素 | 属性 |
|---|---|---|
| Choose 元素 (MSBuild) | Otherwise When |
-- |
| Import 元素 (MSBuild) | -- | 条件 Project |
| ImportGroup 元素 | 导入 | 条件 |
| Item 元素 (MSBuild) | ItemMetaData | 条件 Exclude 包括 删除 |
| ItemDefinitionGroup 元素 (MSBuild) | Item | 条件 |
| ItemGroup 元素 (MSBuild) | Item | 条件 |
| ItemMetadata 元素 (MSBuild) | Item | 条件 |
| OnError 元素 (MSBuild) | -- | 条件 ExecuteTargets |
| Otherwise 元素 (MSBuild) | Choose ItemGroup PropertyGroup |
-- |
| Output 元素 (MSBuild) | -- | 条件 ItemName PropertyName TaskParameter |
| Parameter 元素 | -- | 输出 ParameterType 必需 |
| ParameterGroup 元素 | 参数 | -- |
| Project 元素 (MSBuild) | Choose 导入 ItemGroup ProjectExtensions PropertyGroup 目标 UsingTask |
DefaultTargets InitialTargets Sdk ToolsVersion TreatAsLocalProperty xmlns |
| ProjectExtensions 元素 (MSBuild) | -- | -- |
| Property 元素 (MSBuild) | -- | 条件 |
| PropertyGroup 元素 (MSBuild) | 属性 | 条件 |
| Sdk 元素 (MSBuild) | -- | 名称 版本 |
| Target 元素 (MSBuild) | OnError 任务 |
AfterTargets BeforeTargets 条件 DependsOnTargets 输入 KeepDuplicateOutputs 名称 输出 返回 |
| Target 的 Task 元素 (MSBuild) | 输出 | 条件 ContinueOnError 参数 |
| UsingTask 的 Task 元素 (MSBuild) | 数据 | 评估 |
| UsingTask 元素 (MSBuild) | ParameterGroup 任务 |
AssemblyFile AssemblyName 条件 TaskFactory TaskName |
| When 元素 (MSBuild) | Choose ItemGroup PropertyGroup |
条件 |