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