Specify custom build events in Visual Studio

Applies to: Visual Studio Visual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

By specifying a custom build event, you can automatically run commands before a build starts or after it finishes. For example, you can run a .bat file before a build starts or copy new files to a folder after the build is complete. Build events run only if the build successfully reaches those points in the build process.

For specific information about the programming language that you're using, see the following topics:

• Visual Basic--How to: Specify build events (Visual Basic).

• C# and F#--How to: Specify build events (C#).

• Visual C++--Specify build events.

Syntax

Build events follow the same syntax as DOS commands, but you can use macros to create build events more easily. For a list of available macros, see Pre-build Event/Post-build Event command line dialog box.

For best results, follow these formatting tips:

• Add a call statement before all build events that run .bat files.

  Example: call C:\MyFile.bat

  Example: call C:\MyFile.bat call C:\MyFile2.bat

• Enclose file paths in quotation marks.

  Example (for Windows 8): "%ProgramFiles(x86)%\Microsoft SDKs\Windows\v8.0A\Bin\NETFX 4.0 Tools\gacutil.exe" -if "$(TargetPath)"

• Separate multiple commands by using line breaks.

• Include wildcards as needed.

  Example: for %I in (*.txt *.doc *.html) do copy %I c:\mydirectory\

  Note

  %I in the code above should be %%I in batch scripts.

See also

• Compile and build
• Pre-build Event/Post-build Event command line dialog box
• MSBuild special characters
• Walkthrough: Build an application