Элемент Target (MSBuild)

Содержит набор целевых объектов для MSBuild, подлежащих последовательному выполнению.

<Target Name="Target Name"
        DependsOnTargets="DependentTarget"
        Inputs="Inputs"
        Outputs="Outputs"
        Returns="Returns"
        KeepDuplicateOutputs="true/false"
        BeforeTargets="Targets"
        AfterTargets="Targets"
        Condition="'String A' == 'String B'">
    <Task>... </Task>
    <OnError... />
</Target>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
Name	Обязательный атрибут. Имя целевого объекта.
DependsOnTargets	Необязательный атрибут. Целевые объекты, которые должны быть выполнены перед тем, как можно будет выполнить этот целевой объект или произвести анализ зависимостей высшего уровня. Несколько целевых объектов отделяются друг от друга точкой с запятой.
Returns	Необязательный атрибут. Набор элементов, которые будут доступны для задач, которые используют это целевое значение, например, задач MSBuild. Несколько целевых объектов отделяются друг от друга точкой с запятой.
Inputs	Необязательный атрибут. Входные данные для этого целевого объекта. Элементы внутри этого атрибута используются как входные данные при анализе зависимостей высшего уровня.
Outputs	Необязательный атрибут. Ожидаемые выходные данные этого целевого объекта. Для создания выходных элементов можно преобразовать входные элементы. Дополнительные сведения о преобразованиях см. в разделе Преобразования MSBuild.
BeforeTargets	Необязательный атрибут. Список разделенных точкой с запятой имен целевых объектов.  Если указан, указывает на то, что эта цель должна выполняться перед указанным целевым объектом или объектами.  Это позволяет автору проекта расширять существующий набор целей, не изменяя их непосредственно.
AfterTargets	Необязательный атрибут. Список имен целевых объектов, разделенных точкой с запятой. Если указан, указывает на то, что эта цель должна выполняться после указанного целевым объектом или объектами.  Это позволяет автору проекта расширять существующий набор целей, не изменяя их непосредственно.
KeepDuplicateOutputs	Необязательный атрибут логического типа. Если true, множественные ссылки на один элемент записываются в выходных данных. Значением атрибута по умолчанию является false.
Condition	Необязательный атрибут. Проверяемое условие. Если проверяемое условие имеет значение false, целевой объект не выполняет тело целевого объекта или другие целевые объекты, заданные атрибутом DependsOnTargets. Дополнительные сведения об условиях см. в разделе Условия MSBuild.

Дочерние элементы

Элемент	Описание
Задача	Создает и запускает экземпляр задачи MSBuild. Задача может содержать в цели любое число задач, включая ноль.
OnError	Вызывает выполнение одного или нескольких целевых объектов, если атрибуту ContinueOnError присвоено значение false для задачи, вызвавшей сбой. В целевом объекте может содержаться любое число элементов OnError, включая ноль. Если используются элементы OnError, то они должны быть последними в элементе Target.

Родительские элементы

Элемент	Описание
Проект	Обязательный корневой элемент файла проекта MSBuild.

Заметки

Первый целевой объект, подлежащий выполнению, задается во время выполнения. Целевые объекты могут иметь зависимости от других целевых объектов. Например, целевой объект для развертывания зависит от целевых объектов компиляции. Программа MSBuild обрабатывает зависимости в порядке их расположения в атрибуте DependsOnTargets слева направо. Дополнительные сведения см. в разделе Цели MSBuild.

Целевой объект выполняется только один раз в ходе построения, даже если более одного целевого объекта имеют зависимости от этого целевого объекта.

Если целевой объект пропускается с связи с тем, что атрибут Condition имеет значение false, его можно выполнить, если его вызов осуществляется позже в построении, и при этом его атрибут Condition будет иметь значение true.

До 4 MSBuild Target возвращал все элементы, которые были указаны в атрибуте Outputs . Чтобы сделать это, MSBuild пришлось записывать эти элементы в задачи тестовых случаев позднее при их запросе построением. Поскольку не существовало способа указать, какие целевые объекты имеют необходимый вызывающим объектам вывод, MSBuild собрал все элементы из всех Outputs на всех вызываемых Target. Это приведет к проблемам с масштабом для построений с большим количеством выходных элементов.

Если пользователь указывает Returns для любого элемента Target в проекте, только те Target, которые имеют атрибутReturns , записывают эти элементы.

Target может одновременно содержать атрибуты Outputs и Returns. Outputs используется с Inputs для определения, является ли цель актуальной. Returns, если он присутствует, переопределяет значение Outputs, чтобы определить, какие объекты возвращаются вызывающим объектам. Если не существует Returns, то Outputs будут доступны вызывающим функциям за исключением в случае, описанных ранее.

До MSBuild 4 каждый раз, когда в Target включены несколько ссылок на тот же элемент в его Outputs, эти повторяющиеся элементы будет регистрироваться. В очень больших построениях с большое количество выводов и многие взаимными зависимостями внутри проекта, это приведет к использованию большого объема памяти впустую из-за повторяющихся элементов и их неэффективного использования. Если атрибут KeepDuplicateOutputs имеет значение true, дубликаты не хранятся.

Пример

В следующем примере кода показан элемент Target, выполняющий задачу Csc.

<Target Name="Compile" DependsOnTargets="Resources" Returns="$(TargetPath)">
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

См. также

Основные понятия

Цели MSBuild

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