Элемент UsingTask (MSBuild)

Статья
08/11/2011

Сопоставляет задачу, указанную в элементе Task, со сборкой, содержащей реализацию задачи.

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    TaskFactory = "ClassName"
    Condition="'String A'=='String B'" />

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

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

Атрибуты

Атрибут	Описание
AssemblyName	Обязателен один из следующих атрибутов: AssemblyName или AssemblyFile. Имя загружаемой сборки. Атрибут AssemblyName принимает сборки со строгими именами, но строгие имена не обязательны. Использование этого атрибута эквивалентно загрузке сборки с помощью метода Load в .NET Framework. Этот атрибут нельзя использовать вместе с атрибутом AssemblyFile.
AssemblyFile	Обязательным является либо атрибут AssemblyName, либо атрибут AssemblyFile. Путь к файлу сборки. Этот атрибут может принимать и полные, и относительные пути. Относительные пути задаются относительно файла проекта или файла TARGETS, в котором декларируется элемент UsingTask. Использование этого атрибута эквивалентно загрузке сборки с помощью метода LoadFrom в .NET Framework. Этот атрибут нельзя использовать вместе с атрибутом AssemblyName.
TaskFactory	Необязательный атрибут. Указывает класс в сборке, который отвечает за создание экземпляров указанного имени Task. Пользователь может также указать TaskBody как дочерний элемент, который фабрика задач получает и использует для создания задачи. Содержимое TaskBody являются специфическими для задач завода.
TaskName	Обязательный атрибут. Имя задачи для обращения из сборки. Если возможны неоднозначности, следует указывать полные пространства имен. При наличии неоднозначности MSBuild выбирает произвольное соответствие, что может привести к непредвиденным результатам.
Condition	Необязательный атрибут. Проверяемое условие. Дополнительные сведения см. в разделе Условия MSBuild.

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

Элемент	Описание
ParameterGroup	Набор параметров, которые появляются в задаче, созданной указанным объектом TaskFactory.
TaskBody	Данные, передаваемые в TaskFactory для создания экземпляра задачи.

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

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

Заметки

К переменным среды, свойствам уровня командной строки и проекта можно обращаться отовсюду внутри элемента UsingTask, если он находится в файле проекта, либо явно, либо через импортированный файл проекта. Дополнительные сведения см. в разделе Задачи MSBuild.

Примечание
Свойства уровня проекта не имеют значений, если элемент UsingTask поступает из одного из файлов TASKS, зарегистрированных глобально в ядре MSBuild.Свойства уровня проекта не являются глобальными для MSBuild.

В MSBuild 4.0 UsingTasks может быть загружен из .overridetask файлов.

Пример

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

<UsingTask TaskName="MyTask" AssemblyName="My.Assembly" TaskFactory="MyTaskFactory">
       <ParameterGroup>
              <Parameter1 ParameterType="System.String" Required="False" Output="False"/>
              <Parameter2 ParameterType="System.Int" Required="True" Output="False"/>
              ...
</ParameterGroup>
       <TaskBody>
      ... Task factory-specific data ...
       </TaskBody>
</UsingTask>

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

<UsingTask TaskName="Email"
              AssemblyFile="c:\myTasks\myTask.dll" />

См. также

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

Задачи MSBuild

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

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

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

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