Элемент UsingTask (MSBuild)

Статья
11/16/2008

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

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

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

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

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

Атрибуты

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

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

Отсутствуют.

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

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

Заметки

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

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

Пример

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

<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
              AssemblyName="Microsoft.Build.Tasks" />

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

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

См. также

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

Задачи MSBuild

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

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

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