Debugger.LastBreakReason Property

Reference

Definition

Namespace:: EnvDTE

Assembly:: EnvDTE.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.11.40262

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the last reason that a program was broken. If the program is running it returns DBG_REASON_NONE.

public:
 property EnvDTE::dbgEventReason LastBreakReason { EnvDTE::dbgEventReason get(); };

public:
 property EnvDTE::dbgEventReason LastBreakReason { EnvDTE::dbgEventReason get(); };

[System.Runtime.InteropServices.DispId(109)]
public EnvDTE.dbgEventReason LastBreakReason { [System.Runtime.InteropServices.DispId(109)] get; }

[<System.Runtime.InteropServices.DispId(109)>]
[<get: System.Runtime.InteropServices.DispId(109)>]
member this.LastBreakReason : EnvDTE.dbgEventReason

Public ReadOnly Property LastBreakReason As dbgEventReason

Property Value

dbgEventReason

A dbgEventReason value.

Attributes: DispIdAttribute

Examples

The following example demonstrates how to use the LastBreakReason property.

public static void LastBreakReason(DTE dte)  
{  
    // Setup the debug Output window.  
    Window w = (Window)dte.Windows.Item(EnvDTE.Constants.vsWindowKindOutput);  
    w.Visible = true;  
    OutputWindow ow = (OutputWindow)w.Object;  
    OutputWindowPane owp = ow.OutputWindowPanes.Add("Last Break Reason Test");  
    owp.Activate();  

    owp.OutputString("The reason that a program was broken: ");  
    switch(dte.Debugger.LastBreakReason)  
    {  
        case dbgEventReason.dbgEventReasonBreakpoint:  
            owp.OutputString("Breakpoint hit.");  
            break;  
        case dbgEventReason.dbgEventReasonNone:  
            owp.OutputString("No reason");  
            break;  
        case dbgEventReason.dbgEventReasonExceptionNotHandled:  
            owp.OutputString("Exception not handled by the debuggee");  
            break;  
        case dbgEventReason.dbgEventReasonExceptionThrown:  
            owp.OutputString("Exception thrown");  
            break;  
    }  
}

Shared Sub LastBreakReason(ByRef dte As EnvDTE.DTE)  
    Select Case dte.Debugger.LastBreakReason  
        Case dbgEventReason.dbgEventReasonBreakpoint  
            MessageBox.Show("Breakpoint hit.", "Debugger Test - LastBreakReason")  
        Case dbgEventReason.dbgEventReasonNone  
            MessageBox.Show("No reason", "Debugger Test - LastBreakReason")  
        Case dbgEventReason.dbgEventReasonExceptionNotHandled  
            MessageBox.Show("Exception not handled by the debuggee", _  
                            "Debugger Test - LastBreakReason")  
        Case dbgEventReason.dbgEventReasonExceptionThrown  
            MessageBox.Show("Exception thrown", "Debugger Test - LastBreakReason")  
    End Select  
End Sub

Remarks

LastBreakReason returns a dbgEventReason value indicating why a program broke. A program can be broken for one of the following reasons:

A breakpoint was hit.

Returns a dbgEventReasonBreakpoint.
An exception was thrown.

Returns a dbgEventReasonExceptionThrown.
An exception was thrown but not handled by the program being debugged.

Returns a dbgEventReasonExceptionNotHandled.

If nothing is being debugged or the debugger is in run mode, this property returns dbgEventReasonNone.

Applies to

Share via