This documentation is archived and is not being maintained.

Edit and Continue, Debugging, Options Dialog Box

To access the Edit and Continue page, click the Tools menu and select Options. In the Options dialog box, expand the Debugging folder and select Edit and Continue. This page allows you to set the following options for Edit and Continue. For more information, see Edit and Continue.

Enable Edit and Continue

When selected, enables Edit and Continue.

Edit and Continue allows you to change your source code while your program is in break mode (with some limitations) and applies those changes without having to end the debug session and build your program again.

This setting cannot be changed while debugging.

Invoked by debug commands

When selected, enables Edit and Continue to be invoked by execution commands such as Step.

Ask me first

Tells the debugger to ask you first before invoking Edit and Continue from a debug command. This allows the cancellation of the invocation, if so desired.

Warn me about stale code (Native Only)

When selected, the debugger warns you about stale code with the Stale Code Warning dialog box. (See Stale Code Warning Dialog Box.)

In some cases, Edit and Continue cannot apply code changes to the executable immediately, but may be able to apply the code changes later if you continue debugging. Edit and Continue updates the code at that time. Until the code updates, the source window shows the original code in gray. Because this code has been superceded by code changes, it is outdated or stale. You cannot edit stale code.

Relink code changes after debugging (Native Only)

Relinks native code changes after debugging.

Edit and Continue does not invoke custom build steps. If your program uses custom build steps, you may want to rebuild manually so that custom build steps can be invoked. In that case, you can disable relinking after Edit and Continue to ensure that you are prompted to manually rebuild.

Allow precompiling (Native Only)

Allows Edit and Continue to load and process precompiled headers in the background to speed up processing of code changes. Loading precompiled headers requires allocation of physical memory, which can be a problem if you are compiling on a machine with limited RAM. You can determine if this might be a problem by using the Task Manager to determine the amount of available physical memory while you are debugging. If this amount is greater than the size of your precompiled headers, Edit and Continue should have no problem. If the amount is less than the size of your precompiled headers, you can prevent Edit and Continue from loading precompiled headers in the background by clearing this option.

See Also