This documentation is archived and is not being maintained.

Debugger.Stop Method

Stops debugging, terminating, or detaching from all attached processes.

Namespace: EnvDTE
Assembly: EnvDTE (in envdte.dll)

void Stop (
	[OptionalAttribute] [InAttribute] bool WaitForDesignMode
)
void Stop (
	/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ boolean WaitForDesignMode
)
function Stop (
	WaitForDesignMode : boolean
)

Parameters

WaitForDesignMode

Set to true if the debugging session should stop only when it reaches design mode. Set to false if you intend to stop debugging, but you need to perform other tasks in the macro even before the debugger enters Design mode.

Stop stops debugging and terminates the attached process. See Stopping Execution for more information.

The following example demonstrates how to use the Stop method.

To test this method:

  1. Set a breakpoint in the target application.

  2. Run the target application in Debug mode.

  3. When the application stops at the breakpoint, run the add-in.

public static void Stop(DTE dte)
{
    EnvDTE.Debugger debugger = (EnvDTE.Debugger)dte.Debugger;
    debugger.Stop(true);
}
NoteNote

Macros are run on the main thread of Visual Studio. The following code does not work and the macro loops indefinitely, because the integrated development environment (IDE) never has a chance to enter Design mode. Instead, you should resort to a separate thread or pooling mechanism.

' Bad Code Example.
Sub StopDebuggingAndWaitForDesign
    DTE.Debugger.Stop(False)

    While DTE.Debugger.CurrentMode <> dbgDebugMode.dbgDesignMode
        System.Threading.Thread.Sleep(50)
    End While

    MsgBox("Debugger has been stopped")

End Sub

Show: