Элемент Task (MSBuild)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

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

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

Атрибуты

Атрибут	Описание
Condition	Необязательный атрибут. Проверяемое условие. Дополнительные сведения см. в разделе Условия MSBuild.
ContinueOnError	Необязательный атрибут. Логический атрибут, по умолчанию принимающий значение false, если он не указан. Если ContinueOnError имеет значение false и происходит сбой выполнения задачи, оставшиеся задачи в элементе Target не выполняются, и весь элемент Target считается давшим сбой. Если этот атрибут равен true, выполнение последующих задач в элементе Target продолжается, даже если произошел сбой выполнения текущей задачи, и все ошибки данной задачи трактуются как предупреждения.
Parameter	Обязательный атрибут в случае, если класс содержит одно или несколько свойств с атрибутом [Required]. Определяемый пользователем параметр задачи, значением которого является значение параметра. Элемент Task может содержать любое число параметров, и каждый атрибут соответствует свойству .NET в классе задачи.

Condition

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

ContinueOnError

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

Если этот атрибут равен true, выполнение последующих задач в элементе Target продолжается, даже если произошел сбой выполнения текущей задачи, и все ошибки данной задачи трактуются как предупреждения.

Parameter

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

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

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

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

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

Элемент	Описание
Target	Элемент-контейнер для задач 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>