Элемент Task элемента Target (MSBuild)

Статья
08/25/2023

Создает и выполняет экземпляр задачи MSBuild. Имя элемента определяется именем создаваемой задачи.

Синтаксис

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Элементы и атрибуты

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

Атрибуты

Атрибут	Description
`Condition`	Необязательный атрибут элемента . Проверяемое условие. Дополнительные сведения см. в разделе Условия.
`ContinueOnError`	Необязательный атрибут элемента . Может содержать одно из следующих значений: - WarnAndContinue или true. При сбое задачи последующие задачи в элементе Target и сборке продолжают выполняться, а все ошибки из задачи рассматриваются как предупреждения. - ErrorAndContinue. При сбое задачи последующие задачи в элементе `Target` и сборке продолжают выполняться, а все ошибки из задачи рассматриваются как ошибки. - ErrorAndStop или false (значение по умолчанию). При сбое задачи остальные задачи в элементе `Target` и сборке не выполняются, и считается, что возник сбой всего элемента `Target` и всей сборки. Версии платформы .NET Framework, предшествовавшие 4.5, поддерживали только значения `true` и `false`. Дополнительные сведения см. в руководстве по игнорированию ошибок в задачах.
`Parameter`	Требуется, если класс задачи содержит одно или несколько свойств с атрибутом `[Required]`. Определяемый пользователем параметр задачи, значением которого является значение параметра. В элементе `Task` может существовать любое число параметров, и каждый атрибут соответствует свойству .NET в классе задачи.

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

Элемент	Description
Выходные данные	Сохраняет выходные данные задачи в файле проекта. Задача может содержать нуль и более элементов `Output`.

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

Элемент	Description
Целевой объект	Элемент контейнера для задач MSBuild.

Замечания

Элемент Task в файле проекта MSBuild создает экземпляр задачи, устанавливает для него свойства и выполняет его. Элемент Output сохраняет выходные параметры в свойствах или элементах, которые будут использоваться в другом месте в файле проекта.

Если в родительском элементе Target задачи существуют элементы OnError, они будут обрабатываться даже в случае сбоя задачи, когда ContinueOnError имеет значение false. Дополнительные сведения о задачах см. в разделе Задачи.

Пример

Следующий пример кода создает экземпляр класса задачи Csc, устанавливает шесть свойств и выполняет задачу. После выполнения значение свойства OutputAssembly этого объекта помещается в список элементов с именем FinalAssemblyName.

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

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