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


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

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

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

Параметр

Описание

Condition

Необязательный параметр типа String.

Выражение типа Boolean, используемое ядром MSBuild для определения того, будет ли выполняться данная задача.Сведения об условиях, поддерживаемых MSBuild, см. в разделах Условия MSBuild.

ContinueOnError

Необязательный параметр.Может содержать одно из следующих значений:

  • WarnAndContinue или true.При сбое задачи, последующие задачи в элементе целевой объект и построении продолжают выполняться, и все ошибки из задачи рассматриваются как предупреждения.

  • ErrorAndContinue.При сбое задачи, последующие задачи в элементе Target и построении продолжают выполняться, и все ошибки из задачи следует обрабатывать как ошибки.

  • ErrorAndStop или false (по умолчанию).При сбое задачи, не исполнены остальные задачи в элементе Target и построении и считается, что не удалось весь элемент Target и построение.

Версии платформы .NET Framework до 4,5 поддерживали только значения true и false.

Дополнительные сведения см. в разделе Практическое руководство. Игнорирование ошибок в задачах.

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

  • Базовый класс Task
    Добавление нескольких параметров в задачи, производные от класса Task.

  • Базовый класс TaskExtension
    Добавление нескольких параметров в задачи, производные от класса TaskExtension.

  • Базовый класс ToolTaskExtension
    Добавление нескольких параметров в задачи, производные от класса ToolTaskExtension.

  • Задача AL (компоновщик сборок)
    Создание сборки с манифестом из одного или нескольких файлов, являющихся модулями или файлами ресурсов.

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

  • Задача AssignCulture
    Назначение элементам региональных идентификаторов.

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

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

  • Задача CallTarget
    Вызов целевого объекта в файле проекта.

  • Задача CombinePath
    Объединение указанных путей в один путь.

  • Задача ConvertToAbsolutePath
    Преобразование относительного пути или ссылки в абсолютный путь.

  • Задача Copy
    Копирование файлов в новое расположение.

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

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

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

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

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

  • Задача Delete
    Удаление указанных файлов.

  • Задача 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
    Извлечение идентификаторов сборок из указанных файлов и вывод сведений об удостоверении.

  • Задача GetFrameworkPath
    Извлечение пути к сборкам .NET Framework.

  • Задача GetFrameworkSdkPath
    Извлечение пути к Windows SDK.

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

  • Задача LC
    Создание LICENCE-файла по LICX-файлу.

  • Задача MakeDir
    Создание каталогов и, при необходимости, любых родительских каталогов.

  • Задача Message
    Запись сообщения в журнал в процессе построения.

  • Задача Move
    Перемещение файлов в новое расположение.

  • Задача MSBuild
    Построение проектов MSBuild из другого проекта MSBuild.

  • Задача ReadLinesFromFile
    Чтение списка элементов из текстового файла.

  • Задача RegisterAssembly
    Чтение метаданных из указанной сборки и добавление необходимых записей в реестр.

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

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

  • Задача RequiresFramework35SP1Assembly
    Определяет, требуется ли для приложения платформа .NET Framework 3.5 с пакетом обновления 1 (SP1).

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

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

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

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

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

  • Задача ResolveNativeReference
    Разрешение машинных ссылок.

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

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

  • Задача SignFile
    Подписывание указанного файла указанным сертификатом.

  • Задача Touch
    Установка времени доступа файлов и их изменения.

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

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

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

  • Задача Warning
    Запись предупреждения в журнал в процессе построения на основании вычисленного условного оператора.

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

  • Задача WriteLinesToFile
    Запись выбранных элементов в указанный текстовый файл.

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

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

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

См. также

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

Написание задач

Задачи MSBuild

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

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