分享方式:


MSBuild 專案檔案結構描述參考

提供表格來說明所有的 MSBuild XML 結構描述元素及其可用屬性和子項目。

MSBuild 使用專案檔,來指示建置引擎要建置哪些項目以及如何建置。 MSBuild 專案檔是遵守 MSBuild XML 結構描述的 XML 檔案。 本節說明適用於 MSBuild 的 XML 結構描述定義 (.xsd) 檔。

MSBuild XSD 結構描述定義檔案

Visual Studio 2017 和更新版本中不需要 MSBuild 專案檔中的結構描述連結。 如果存在,則不論 Visual Studio 的版本為何,都應為 http://schemas.microsoft.com/developer/msbuild/2003。 此值不是即時 Web 目的地; 最新的 MSBuild 結構描述定義檔 (.xsd檔案) 可在 Microsoft.Build.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

--
Import 項目 (MSBuild) -- 條件

計畫
ImportGroup 項目 Import 條件
Item 項目 (MSBuild) ItemMetaData 條件

排除

包括​​

移除
ItemDefinitionGroup 項目 (MSBuild) 項目 條件
ItemGroup 項目 (MSBuild) 項目 條件
ItemMetadata 項目 (MSBuild) 項目 條件
OnError 項目 (MSBuild) -- 條件

ExecuteTargets
Otherwise 元素 (MSBuild) 選擇

ItemGroup

PropertyGroup
--
Output 項目 (MSBuild) -- 條件

ItemName

PropertyName

TaskParameter
Parameter 項目 -- 輸出

ParameterType

必要
ParameterGroup 項目 參數 --
Project 項目 (MSBuild) 選擇

Import

ItemGroup

ProjectExtensions

PropertyGroup

目標

UsingTask
DefaultTargets

InitialTargets

Sdk

ToolsVersion

TreatAsLocalProperty

xmlns
ProjectExtensions 項目 (MSBuild) -- --
Property 元素 (MSBuild) -- 條件
PropertyGroup 項目 (MSBuild) 屬性 條件
Sdk 項目 (MSBuild) -- 名稱

版本
Target 項目 (MSBuild) OnError

Task
AfterTargets

BeforeTargets

條件

DependsOnTargets

輸入

KeepDuplicateOutputs

名稱

輸出

傳回
Target 的 Task 元素 (MSBuild) 輸出 條件

ContinueOnError

參數
UsingTask 的 Task 元素 (MSBuild) Data 評估
UsingTask 項目 (MSBuild) ParameterGroup

Task
AssemblyFile

AssemblyName

條件

TaskFactory

TaskName
When 元素 (MSBuild) 選擇

ItemGroup

PropertyGroup
條件

另請參閱