Поделиться через


Справочник по схеме файла проекта MSBuild

Предоставляет таблицу всех элементов СХЕМЫ XML MSBuild со своими доступными атрибутами и дочерними элементами.

MSBuild использует файлы проекта, чтобы указать подсистеме сборки, что нужно создать и как ее создать. Файлы проекта MSBuild — это XML-файлы, которые соответствуют схеме XML MSBuild. В этом разделе описан файл определения схемы XML (XSD) для MSBuild.

Файлы определения схемы XSD MSBuild

Ссылка на схему в файле проекта MSBuild не требуется в Visual Studio 2017 и более поздних версиях. Если он присутствует, он должен быть http://schemas.microsoft.com/developer/msbuild/2003 независимо от версии Visual Studio. Это значение не является динамическим веб-назначением; Самый актуальный файл определения схемы MSBuild (.xsd файл) можно найти в Microsoft.Build.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. Вы также можете найти все файлы определения схемы XSD MSBuild в папке установки Visual Studio в разделе Xml\Schemas\1033\MSBuild.

Дополнительные сведения о версиях MSBuild, включая таблицу соответствующих версий пакета SDK для .NET, см. в разделе "Обзор версий .NET, MSBuild и Visual Studio".

Элементы схемы XML MSBuild

В следующей таблице перечислены все элементы схемы XML MSBuild, а также дочерние элементы и атрибуты.

Элемент Дочерние элементы 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 Parameter --
Элемент Project (MSBuild) Выбирать

Import

ItemGroup

ProjectExtensions

PropertyGroup

Target

UsingTask
DefaultTargets

InitialTargets

Пакет SDK

ToolsVersion

TreatAsLocalProperty

xmlns
Элемент ProjectExtensions (MSBuild) -- --
Элемент Property (MSBuild) -- Condition
Элемент PropertyGroup (MSBuild) Property Condition
Элемент Sdk (MSBuild) -- Имя

Версия
Целевой элемент (MSBuild) OnError

Задача
AfterTargets

BeforeTargets

Condition

DependsOnTargets

Входные данные

KeepDuplicateOutputs

Имя

Выходы

Возвраты
Элемент Task объекта Target (MSBuild) Выходные данные Condition

ContinueOnError

Parameter
Элемент Task объекта UsingTask (MSBuild) Данные Evaluate
Элемент UsingTask (MSBuild) ParameterGroup

Задача
AssemblyFile

Имя сборки

Condition

TaskFactory

Имя задачи
Элемент When (MSBuild) Выбирать

ItemGroup

PropertyGroup
Condition

См. также