Справочные сведения о схеме файлов проектов 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,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. Вы также можете найти все файлы определения схемы XSD MSBuild в папке установки Visual Studio в разделе Xml\Schemas\1033\MSBuild.

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

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

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

Элемент Дочерние элементы Атрибуты
Элемент Choose (MSBuild) Otherwise

When		 --
Элемент Import (MSBuild) -- Condition

Проект
Элемент ImportGroup Импорт Condition
Элемент Item (MSBuild) ItemMetaData Condition

Исключить

Включение

Удалить
Элемент ItemDefinitionGroup (MSBuild) Позиция Condition
Элемент ItemGroup (MSBuild) Позиция Condition
Элемент ItemMetadata (MSBuild) Позиция Condition
Элемент OnError (MSBuild) -- Condition

ExecuteTargets
Элемент Otherwise (MSBuild) Выберите

ItemGroup

PropertyGroup		 --
Элемент Output (MSBuild) -- Condition

Название товара

PropertyName

TaskParameter
Элемент Parameter -- Выходные данные

ParameterType

Обязательное поле
Элемент ParameterGroup Параметр --
Элемент Project (MSBuild) Выберите

Импорт

ItemGroup

ProjectExtensions

PropertyGroup

Назначение

UsingTask		 DefaultTargets

InitialTargets

Sdk

ToolsVersion

TreatAsLocalProperty

xmlns
Элемент ProjectExtensions (MSBuild) -- --
Элемент Property (MSBuild) -- Condition
Элемент PropertyGroup (MSBuild) Свойство Condition
Элемент SDK (MSBuild) -- Имя

Версия
Элемент Target (MSBuild) OnError

Задача		 AfterTargets

BeforeTargets

Condition

DependsOnTargets

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

KeepDuplicateOutputs

Имя

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

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

ContinueOnError

Параметр
Элемент Task элемента UsingTask (MSBuild) Данные Вычислить
Элемент UsingTask (MSBuild) ParameterGroup

Задача		 AssemblyFile

AssemblyName

Condition

TaskFactory

TaskName
Элемент When (MSBuild) Выберите

ItemGroup

PropertyGroup		 Condition

См. также