Breakpoint.Condition プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

ブレークポイントの条件を指定します。

名前空間 : EnvDTE
アセンブリ : EnvDTE (EnvDTE.dll 内)

構文

'宣言
ReadOnly Property Condition As String
'使用
Dim instance As Breakpoint
Dim value As String

value = instance.Condition

string Condition { get; }

property String^ Condition {
    String^ get ();
}

function get Condition () : String

プロパティ値

型 : System.String

プロパティのブレークポイントの条件を表す文字列。

解説

ブレークポイントに達した時点でプログラムを中断するかどうかを指定するオプションのプロパティです。この条件は、[ブレークポイントの条件] ダイアログボックスで指定します。

返される文字列は、通常、ブレークポイントにいつヒットしたかを判断するために使用される式です。

例

Condition プロパティの使用方法を次の例に示します。

このプロパティをテストするには

アドインを実行します。
ターゲットアプリケーションを実行します。

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