Breakpoint2.Condition Property

Definition

Namespace:

EnvDTE80

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.11.40262

Gets the condition that triggers a breakpoint.

public:
 property System::String ^ Condition { System::String ^ get(); };

public:
 property Platform::String ^ Condition { Platform::String ^ get(); };

[System.Runtime.InteropServices.DispId(109)]
public string Condition { [System.Runtime.InteropServices.DispId(109)] get; }

[<System.Runtime.InteropServices.DispId(109)>]
[<get: System.Runtime.InteropServices.DispId(109)>]
member this.Condition : string

Public ReadOnly Property Condition As String

Property Value

String

A string containing the condition that triggers the breakpoint.

Implements

Condition

Attributes

DispIdAttribute

Examples

The following example demonstrates how to use the Condition property.

public static void Condition(EnvDTE80.DTE2 dte)  
{  
    // Setup 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("Breakpoint Condition and Type are: ");  
    owp.Activate();  

    EnvDTE80.Debugger2 debugger = (EnvDTE80.Debugger2)dte.Debugger;  
    // Stop at the breakpoint, if TempC < TempF is true  
    debugger.Breakpoints.Add("", "Target001.cs", 15, 1, "tempC < tempF",  
                             EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue,  
                             "C#", "", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone);  
    string strCondition = debugger.Breakpoints.Item(1).Condition;  
    string strConditionType = debugger.Breakpoints.Item(1).ConditionType.ToString();  
    owp.OutputString(strCondition + "\n" + strConditionType);  
}  

Remarks

A condition is an optional property that determines whether your program breaks when the breakpoint is reached.

This condition is specified in the Breakpoint Condition dialog box.