Share via

Страница "Событий построения" в конструкторе проектов (C#)

  • Статья

Страница События сборки в конструкторе проектов позволяет задать инструкции по конфигурации сборки. На ней также можно указать условия, при которых будут выполняться события, следующие после сборки. Дополнительные сведения см. в разделе "Практическое руководство. Указание событий сборки (C#) и практическое руководство. Указание событий сборки (Visual Basic)".

Список элементов пользовательского интерфейса

Конфигурация

Данный элемент управления нельзя изменить на этой странице. Описание этого элемента управления см. в статье Страница "Сборка" в конструкторе проектов (C#).

Платформа

Этот элемент управления нельзя изменить на этой странице. Описание этого элемента управления см. в статье Страница "Сборка" в конструкторе проектов (C#).

Командная строка события перед сборкой

Определяет команды, выполняемые перед началом сборки. Для ввода длинных команд нажмите кнопку Изменить событие "Перед сборкой", чтобы открыть диалоговое окно "Командная строка события перед сборкой" или "Командная строка события после сборки".

Примечание.

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

Командная строка события после сборки

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

Примечание.

Добавьте оператор call перед всеми командами после сборки, запускающими BAT-файлы. Например, call C:\MyFile.bat или call C:\MyFile.bat call C:\MyFile2.bat.

Выполнить событие после сборки

Определяет следующие условия для выполнения события после сборки, как показано в приведенной ниже таблице.

Параметр Результат
Всегда Событие после сборки будет выполняться независимо от успешности сборки.
При удачной сборке Событие после сборки будет выполняться в случае успешной сборки. Событие будет выполняться даже для актуального проекта, если его сборка завершилась успешно.
При обновлении выходных файлов проекта во время сборки Событие после сборки будет выполняться только в том случае, если выходной файл компилятора (EXE или DLL) отличается от предыдущего выходного файла компилятора. Таким образом, событие после сборки не выполняется, если проект актуален.

В файле проекта

В более ранних версиях Visual Studio при изменении настроек PreBuildEvent или PostBuildEvent в IDE Visual Studio добавляет в файл проекта свойство PreBuildEvent или PostBuildEvent. Так, например, если параметр командной строки PreBuildEvent в IDE следующая:

"$(ProjectDir)PreBuildEvent.bat" "$(ProjectDir)..\" "$(ProjectDir)" "$(TargetDir)"

затем параметр файла проекта имеет значение.

<PropertyGroup>
    <PreBuildEvent>"$(ProjectDir)PreBuildEvent.bat" "$(ProjectDir)..\" "$(ProjectDir)" "$(TargetDir)" />
</PropertyGroup>

Для проектов .NET Core система Visual Studio 2019 (и Visual Studio 2017 в более последних обновлениях) добавляет целевой объект MSBuild с именем PreBuild или PostBuild для параметров PreBuildEvent и PostBuildEvent. Эти целевые объекты используют атрибуты BeforeTargets и AfterTargets, распознаваемые MSBuild. Например, для предыдущего примера Visual Studio теперь создаст следующий код:

<Target Name="PreBuild" BeforeTargets="PreBuildEvent">
    <Exec Command="&quot;$(ProjectDir)PreBuildEvent.bat&quot; &quot;$(ProjectDir)..\&quot; &quot;$(ProjectDir)&quot; &quot;$(TargetDir)&quot;" />
</Target>

Для события после сборки используйте имя PostBuild и присвойте атрибуту AfterTargets значение PostBuildEvent.

<Target Name="PostBuild" AfterTargets="PostBuildEvent">
   <Exec Command="echo Output written to $(TargetDir)" />
</Target>

Примечание.

Эти изменения файла проекта были сделаны для поддержки проектов в стиле пакетов SDK. Если вы выполняете миграцию файла проекта из старого формата в формат пакета SDK вручную, следует удалить свойства PreBuildEvent и PostBuildEvent, после чего заменить их целевыми объектами PreBuild и PostBuild, как показано в предыдущем коде. Чтобы узнать, как определить, является ли ваш проект проектом в формате пакета SDK, см. раздел Проверка формата проекта.

См. также