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


Справочник по задачам 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. Не предназначен для непосредственного использования.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Задача ResGen

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также