This topic has not yet been rated - Rate this topic

Breakpoint.Condition Property

Visual Studio 2005

Specifies the condition for the breakpoint.

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

string Condition { get; }

/** @property */
String get_Condition ()

JScript

function get Condition () : String

Property Value

A string representing the breakpoint condition for the property.

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.

The returned string is usually an expression used to determine when a breakpoint is hit.

Example

The following example demonstrates how to use the Condition property.

To test this property:

Run the add-in.
Run the target application.

public static void Condition(DTE 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 Test: ");
    owp.Activate();
    
    //dte is a reference to the DTE object passed to you by the
    //OnConnection method that you implement when you create an add-in.
    EnvDTE.Debugger debugger = (EnvDTE.Debugger)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);
}

Tasks

How to: Specify a Breakpoint Condition
How to: Specify a Hit Count

Reference

Breakpoint Interface
Breakpoint Members
EnvDTE Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD