Элемент Project (MSBuild)
Обязательный корневой элемент файла проекта MSBuild.
<Project InitialTargets="TargetA;TargetB"
DefaultTargets="TargetC;TargetD"
TreatAsLocalProperty="PropertyA;PropertyB"
ToolsVersion=<version number>
xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<Choose>... </Choose>
<PropertyGroup>... </PropertyGroup>
<ItemGroup>... </ItemGroup>
<Target>... </Target>
<UsingTask.../>
<ProjectExtensions>... </ProjectExtensions>
<Import... />
</Project>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
DefaultTargets |
Необязательный атрибут. Целевой объект или объекты, по умолчанию являющиеся точкой входа для построения, если целевой объект не задан. Если имеется несколько целевых объектов, они разделяются точкой с запятой (;). Если целевой объект по умолчанию не задан ни в атрибуте DefaultTargets, ни в командной строке MSBuild, ядро запускает первый целевой объект в файле проекта после анализа элементов Import. |
InitialTargets |
Необязательный атрибут. Исходный целевой объект или объекты, выполняемые до целевых объектов, заданных в атрибуте DefaultTargets или в командной строке. Если имеется несколько целевых объектов, они разделяются точкой с запятой (;). |
ToolsVersion |
Необязательный атрибут. Версия набора инструментов MSBuild, используемая для определения значений $(MSBuildBinPath) и $(MSBuildToolsPath). |
TreatAsLocalProperty |
Необязательный атрибут. Имена свойств, которые не будут учитываться, что были глобальными. Этот атрибут исключает определенные свойства командной строки переопределять значения свойств, установленных в файл проекта или целевых объектов и все последующие импорты. Несколько свойств в качестве разделителя используется точка с запятой (;). Обычно глобальных свойств переопределяют значения свойств, установленных в проект или файл целевых объектов. Если свойство перечислитьо в значении TreatAsLocalProperty, то глобальное значение свойства не переопределяет значения свойств, установленных в этот файл и все последующие импорты. Дополнительные сведения см. в разделе Практическое руководство. Построение одинаковых исходных файлов с различными параметрами. Примечание Свойства можно задать глобальные в командной строке с помощью /property (или /p) переключения.Можно также установить или изменить глобальные свойства для проектов дочернего элемента multi- в построении проекта MSBuild с помощью атрибута Properties задайте действие.Дополнительные сведения см. в разделе Задача MSBuild. |
Xmlns |
Обязательный атрибут. Атрибут xmlns должен иметь значение "https://schemas.microsoft.com/developer/msbuild/2003". |
Дочерние элементы
Элемент |
Описание |
|---|---|
Необязательный элемент. Вычисляет значения дочерних элементов, чтобы можно было выбрать один набор элементов ItemGroup или PropertyGroup для вычисления. |
|
Необязательный элемент. Позволяет импортировать в файл проекта другой файл проекта. В проекте может быть любое число элементов Import, включая ноль. |
|
Необязательный элемент. Элемент, предназначенный для группировки отдельных элементов. Группируемые элементы задаются при помощи элемента Item. В проекте может быть любое число элементов ItemGroup, включая ноль. |
|
Необязательный элемент. Обеспечивает возможность сохранения в файле проекта MSBuild информации, не относящейся к MSBuild. В проекте может быть максимум один элемент ProjectExtensions. |
|
Необязательный элемент. Элемент, предназначенный для группировки отдельных свойств. Группируемые свойства задаются при помощи элемента Property. В проекте может быть любое число элементов PropertyGroup, включая ноль. |
|
Необязательный элемент. Содержит набор задач для MSBuild, подлежащих последовательному выполнению. Задачи указываются при помощи элемента Task. В проекте может быть любое число элементов Target, включая ноль. |
|
Необязательный элемент. Позволяет регистрировать задачи в MSBuild. В проекте может быть любое число элементов UsingTask, включая ноль. |
Родительские элементы
Отсутствует.
См. также
Задачи
Практическое руководство. Выбор цели для первого построения
Ссылки
Справочник по командной строке MSBuild
Основные понятия
Справочные сведения о схеме файлов проектов MSBuild