Breakpoint.Condition Property
Specifies the condition for the breakpoint.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Syntax
'Declaration
ReadOnly Property Condition As String
string Condition { get; }
property String^ Condition {
String^ get ();
}
abstract Condition : string with get
function get Condition () : String
Property Value
Type: System.String
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.
Examples
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);
}
Shared Sub Condition(ByRef dte As EnvDTE.DTE)
Dim strCondition As String
Dim strType As String
dte.Debugger.StepInto(True)
dte.Debugger.Breakpoints.Add("", "Target001.cs", 15, 1, "tempC < tempF", _
EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, _
"C#", "", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone)
strCondition = dte.Debugger.Breakpoints.Item(1).Condition.ToString()
strType = dte.Debugger.Breakpoints.Item(1).ConditionType.ToString()
MessageBox.Show("Condition Property Test: " + vbCrLf + _
strCondition + vbCrLf + strType)
End Sub
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.