提供所有 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.xsd 和 Microsoft.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 |