How to: Specify Pre- and Post-Instrument Commands
Note
This article applies to Visual Studio 2015. 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
You can specify commands that run before or after the binaries in a performance session are instrumented. Any command that can be issued from the command line can be specified as a pre-instrument or a post-instrument event. For example, you can specify commands that automate the resigning of an assembly with a strong name key in a batch file that is executed after the binaries are instrumented.
You can specify commands for all instrumented binaries in the profiling run or for individual binaries. However, you can specify only one pre-instrument command to run before and only one post-instrument command to run after the instrumentation process. You cannot specify commands for both all binaries and for individual binaries. When you specify commands for all binaries, the commands are run before or after the instrumentation of each binary in the session.
Requirements
Visual Studio Ultimate, Visual Studio Premium, Visual Studio Professional
The working directory in which the commands are executed depends on the operating systen where you are running Visual Studio and on the target platform of the profiled application.
32-bit computers
On 32-bit computers, the default profiler tools directory is Drive\Program Files\Microsoft Visual Studio 10.0\Team Tools\Performance Tools.
64-bit computers
On 64-bit computers, specify the path according to the target platform of the profiled application:
For 32-bit applications, the default profiler tools directory is:
Drive\Program Files (x86)\Microsoft Visual Studio 10.0\Team Tools\Performance Tools
For 64-bit applications, the default profiler tools directory is:
Drive\Program Files (x86)\Microsoft Visual Studio 10.0\Team Tools\Performance Tools\x64
To specify pre-instrument commands
Perform one of the following steps:
To specify pre-instrument commands for all binaries in a performance session, select the performance session node in Performance Explorer, and then right-click and select Properties.
To specify pre-instrument commands for a specific binary, right-click the name of the binary in the Targets list of the performance session, and then select Properties.
In the Property Pages, click Instrumentation.
Type the command in the Command line text box under Pre-Instrument events.
Note
You can click the ellipsis button (…) that is adjacent to the Command line box to browse to and select the appropriate .exe, .cmd, or .bat file.
Click OK.
To disable the command from running without removing it, select the Exclude from instrumentation check box. To modify compiler or linker settings, use the project property pages.
To specify post-instrument commands
Perform one of the following steps:
To specify post-instrument commands for all binaries in a performance session, select the performance session node in Performance Explorer, and then right-click and select Properties.
To specify post-instrument commands for a specific binary, right-click the name of the binary in the Targets list of the performance session, and then select Properties.
In the Property Pages, click Instrumentation.
Type the command in the Command line text box under Post-Instrument events.
Note
You can click the ellipsis button (…) that is adjacent to the Command line box to browse to and select the appropriate .exe, .cmd, or .bat file.
Click OK.
To disable the command from running without removing it, select the Exclude from instrumentation check box. To modify compiler or linker settings, use the project property pages.