Breakpoint2.Condition Property

Gets the condition that triggers a breakpoint.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
ReadOnly Property Condition As String
string Condition { get; }
property String^ Condition {
    String^ get ();
}
abstract Condition : string
function get Condition () : String

Property Value

Type: System.String
A string containing the condition that triggers the breakpoint.

Implements

Breakpoint.Condition

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.

Examples

The following example demonstrates how to use the Condition property.

To test this property:

  1. Run the add-in.

  2. Run the target application.

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();

    // dte is a reference to the DTE2 object passed to you by the
    // OnConnection method that you implement when you create an Add-in.
    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);
}

.NET Framework Security

See Also

Reference

Breakpoint2 Interface

EnvDTE80 Namespace

Other Resources

How to: Compile and Run the Automation Object Model Code Examples

How to: Specify a Breakpoint Condition