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