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

  • Статья

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

<Project><Target>

Синтаксис

<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>

См. также