Справочник по задачам MSBuild

Задачи содержат код, который выполняется в процессе сборки. Задачи в следующем списке входят в состав MSBuild. После установки рабочей нагрузки C++ станут доступны дополнительные задачи, используемые для создания проектов C++. Дополнительные сведения см. в разделе Задачи C++.

Помимо параметров, перечисленных в подразделах этого раздела, у каждой задачи существуют следующие параметры:

Параметр	Описание
Condition	Необязательный параметр String. Выражение Boolean, на основании которого механизм MSBuild определяет, будет ли выполняться эта задача. Сведения о поддерживаемых в MSBuild условиях см. в статье об условиях.
ContinueOnError	Необязательный параметр. Может содержать одно из следующих значений: - WarnAndContinue или true. При сбое задачи последующие задачи в элементе Target и сборке продолжают выполняться, а все ошибки из задачи рассматриваются как предупреждения. - ErrorAndContinue. При сбое задачи последующие задачи в элементе Target и сборке продолжают выполняться, а все ошибки из задачи рассматриваются как ошибки. - ErrorAndStop или false (значение по умолчанию). При сбое задачи остальные задачи в элементе Target и сборке не выполняются, и считается, что возник сбой всего элемента Target и всей сборки. Версии платформы .NET Framework, предшествовавшие 4.5, поддерживали только значения true и false. Дополнительные сведения см. в руководстве по игнорированию ошибок в задачах.

В этом разделе

• Базовый класс Task

Добавляет несколько параметров в задачи, производные от класса Task. Не предназначен для непосредственного использования.

• Базовый класс TaskExtension

Добавляет несколько параметров в задачи, производные от класса TaskExtension. Не предназначен для непосредственного использования.

• Базовый класс ToolTaskExtension

Добавляет несколько параметров в задачи, производные от класса ToolTaskExtension. Не предназначен для непосредственного использования.

• Задача AL (компоновщик сборок)

Создает сборку с манифестом из одного или нескольких файлов, являющихся модулями или файлами ресурсов.

• Задача AspNetCompiler

Создает оболочку для программы aspnet_compiler.exe, которая выполняет предварительную компиляцию приложений ASP.NET.

• Задача AssignCulture

Назначает элементам идентификаторы языка.

• Задача AssignProjectConfiguration

Принимает строки конфигурации списка и назначает их конкретным проектам.

• Задача AssignTargetPath

Принимает список файлов и добавляет атрибуты <TargetPath>, если они еще не указаны.

• Задача CallTarget

Вызывает целевой объект в файле проекта.

• Задача CombinePath

Объединяет указанные пути в единый путь.

• Задача ConvertToAbsolutePath

Преобразует относительный путь или ссылку в абсолютный путь.

• Задача Copy

Копирует файлы в новое расположение.

• Задача CreateCSharpManifestResourceName

Создает имя манифеста в стиле C# на основе заданного имени RESX-файла или другого ресурса.

• Задача CreateItem

Заполняет коллекции элементов входными элементами, позволяя копировать элементы из одного списка в другой.

• Задача CreateProperty

Заполняет свойства входными значениями, позволяя копировать значения из одного свойства или строки в другое свойство или строку.

• Задача CreateVisualBasicManifestResourceName

Создает имя манифеста в стиле Visual Basic на основе заданного имени RESX-файла или другого ресурса.

• Задача Csc

Вызывает компилятор Visual C# для создания исполняемых файлов, библиотек динамической компоновки или модулей кода.

• Задача Delete

Удаляет указанные файлы.

• Задача DownloadFile

Скачивает файл в заданное расположение.

• Задача Error

Останавливает сборку и регистрирует ошибку в журнале событий на основании вычисленного условного оператора.

• Задача Exec

Запускает заданную программу или команду с помощью заданных аргументов.

• Задача FindAppConfigFile

Выполняет поиск файла app.config (если он имеется) в предоставленных списках.

• Задача FindInList

Выполняет поиск элемента с указанной спецификацией в заданном списке.

• Задача FindUnderPath

Определяет, какие элементы в указанной коллекции находятся в указанной папке и ее подпапках.

• Задача FormatUrl

Преобразовывает URL-адрес в правильный формат URL-адреса.

• Задача FormatVersion

Добавляет номер редакции к номеру версии.

• Задача GenerateApplicationManifest

Создает манифест приложения ClickOnce или собственный манифест.

• Задача GenerateBootstrapper

Задача обеспечивает автоматическое обнаружение, скачивание и установку приложения и необходимых для него компонентов.

• Задача GenerateDeploymentManifest

Создает манифест развертывания ClickOnce.

• Задача GenerateResource

Преобразовывает файлы TXT и RESX в двоичные файлы RESOURCES среды CLR.

• Задача GenerateTrustInfo

Создает доверие к приложению из базового манифеста и из параметров TargetZone и ExcludedPermissions.

• Задача GetAssemblyIdentity

Извлекает идентификаторы сборок из указанных файлов и выводит сведения об удостоверении.

• Задача GetFileHash

Вычисляет контрольные суммы содержимого файла или набора файлов.

• Задача GetFrameworkPath

Извлекает путь к сборкам .NET Framework.

• Задача GetFrameworkSdkPath

Извлекает путь к пакету средств разработки программного обеспечения (SDK) Windows.

• Задача GetReferenceAssemblyPaths

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

• Задача LC

Создает файл LICENSE из файла LICX.

• Задача MakeDir

Создает каталоги и при необходимости любые родительские каталоги.

• Задача Message

Записывает сообщения в журнал в процессе сборки.

• Задача Move

Перемещает файлы в новое расположение.

• Задача MSBuild

Выполняет сборку проектов MSBuild из другого проекта MSBuild.

• Задача ReadLinesFromFile

Считывает список элементов из текстового файла.

• Задача RegisterAssembly

Считывает метаданные из указанной сборки и добавляет в реестр необходимые записи.

• Задача RemoveDir

Удаляет указанные каталоги и все содержащиеся в них файлы и подкаталоги.

• Задача RemoveDuplicates

Удаляет повторяющиеся элементы из указанной коллекции элементов.

• Задача RequiresFramework35SP1Assembly

Определяет, требуется ли для приложения платформа .NET Framework 3.5 SP1.

• Задача ResGen

Является устаревшей. Используйте задачу GenerateResource для преобразования файлов TXT и RESX в двоичные файлы RESOURCES среды CLR и обратно.

• Задача ResolveAssemblyReference

Определяет все сборки, которые зависят от указанных сборок.

• Задача ResolveComReference

Задача принимает список из одной или нескольких библиотек типов или файлов TLB и определяет расположение этих библиотек на диске.

• Задача ResolveKeySource

Определяет источник ключа строгого имени.

• Задача ResolveManifestFiles

Разрешает следующие элементы в процессе сборки в файлы для создания манифеста: элементы сборки, зависимости, вспомогательные элементы, содержимое, отладочные символы и документация.

• Задача ResolveNativeReference

Разрешает машинные ссылки.

• Задача ResolveNonMSBuildProjectOutput

Определяет выходные файлы для ссылок на проекты, не относящихся к MSBuild.

• Задача SGen

Создает сборку сериализации XML для типов в указанной сборке.

• Задача SignFile

Подписывает указанный файл с помощью заданного сертификата.

• Задача Touch

Задает время доступа и изменения файлов.

• Задача UnregisterAssembly

Отменяет регистрацию указанных сборок для целей COM-взаимодействия.

• Задача Unzip

Распаковывает ZIP-архив в заданное расположение.

• Задача UpdateManifest

Обновляет выбранные свойства в манифесте и выполняет повторное подписание.

• Задача Vbc

Вызывает компилятор Visual Basic для создания исполняемых файлов, библиотек динамической компоновки или модулей кода.

• Задача VerifyFileHash

Проверяет, что файл соответствует ожидаемому хэшу файла.

• Задача Warning

Регистрирует в журнале предупреждение в процессе сборки на основе вычисленного условного оператора.

• Задача WriteCodeFragment

Создает временный файл кода с использованием созданного указанного фрагмента кода. Не удаляет этот файл.

• Задача WriteLinesToFile

Записывает указанные элементы в указанный текстовый файл.

• Задача XmlPeek

Возвращает из XML-файла значения, указанные в запросе XPath.

• Задача XmlPoke

Задает в XML-файле значения, указанные в запросе XPath.

• Задача XslTransformation

Преобразует входные данные XML с помощью XSLT или скомпилированного XSLT и выводит результат на устройство вывода или в выходной файл.

• Задача ZipDirectory

Создает ZIP-архив из содержимого каталога.

См. также

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