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		 条件

另请参阅