Элемент Task (MSBuild)

Статья
02/20/2013

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

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

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

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

Атрибуты

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

Condition

Необязательный атрибут.Проверяемое условие.Дополнительные сведения см. в разделе Условия MSBuild.

ContinueOnError

Необязательный атрибут.Может содержать одно из следующих значений:

WarnAndContinue или true.При сбое задачи, последующие задачи в элементе целевой объект и построении продолжают выполняться, и все ошибки из задачи рассматриваются как предупреждения.
ErrorAndContinue.При сбое задачи, последующие задачи в элементе Target и построении продолжают выполняться, и все ошибки из задачи следует обрабатывать как ошибки.
ErrorAndStop или false (по умолчанию).При сбое задачи, не исполнены остальные задачи в элементе Target и построении и считается, что не удалось весь элемент Target и построение.

Версии платформы .NET Framework до 4,5 поддерживали только значения true и false.

Дополнительные сведения см. в разделе Практическое руководство. Игнорирование ошибок в задачах.

Parameter

Обязательный атрибут в случае, если класс содержит одно или несколько свойств с атрибутом [Required].

Определяемый пользователем параметр задачи, значением которого является значение параметра.Элемент Task может содержать любое число параметров, и каждый атрибут соответствует свойству .NET в классе задачи.

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

Элемент	Описание
Output	Задает сохранение выходных данных задачи в файле проекта.Задача может содержать любое число элементов Output, включая ноль.

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

Элемент	Описание
Целевой объект	Элемент-контейнер для задач MSBuild.

Заметки

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

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

Пример

В следующем примере кода создается экземпляр класса Csc task, устанавливается шесть из его свойств, после чего задача выполняется.После выполнения значение свойства 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>

См. также

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

Задачи MSBuild

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

Другие ресурсы

Справочные сведения о задачах MSBuild

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