Breakpoints.Add メソッド

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

更新 : 2007 年 11 月

新しいブレークポイントを作成して有効にします。

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

構文

'宣言
Function Add ( _
    Function As String, _
    File As String, _
    Line As Integer, _
    Column As Integer, _
    Condition As String, _
    ConditionType As dbgBreakpointConditionType, _
    Language As String, _
    Data As String, _
    DataCount As Integer, _
    Address As String, _
    HitCount As Integer, _
    HitCountType As dbgHitCountType _
) As Breakpoints
'使用
Dim instance As Breakpoints
Dim Function As String
Dim File As String
Dim Line As Integer
Dim Column As Integer
Dim Condition As String
Dim ConditionType As dbgBreakpointConditionType
Dim Language As String
Dim Data As String
Dim DataCount As Integer
Dim Address As String
Dim HitCount As Integer
Dim HitCountType As dbgHitCountType
Dim returnValue As Breakpoints

returnValue = instance.Add(Function, File, _
    Line, Column, Condition, ConditionType, _
    Language, Data, DataCount, Address, _
    HitCount, HitCountType)

Breakpoints Add(
    string Function,
    string File,
    int Line,
    int Column,
    string Condition,
    dbgBreakpointConditionType ConditionType,
    string Language,
    string Data,
    int DataCount,
    string Address,
    int HitCount,
    dbgHitCountType HitCountType
)

Breakpoints^ Add(
    [InAttribute] String^ Function, 
    [InAttribute] String^ File, 
    [InAttribute] int Line, 
    [InAttribute] int Column, 
    [InAttribute] String^ Condition, 
    [InAttribute] dbgBreakpointConditionType ConditionType, 
    [InAttribute] String^ Language, 
    [InAttribute] String^ Data, 
    [InAttribute] int DataCount, 
    [InAttribute] String^ Address, 
    [InAttribute] int HitCount, 
    [InAttribute] dbgHitCountType HitCountType
)

function Add(
    Function : String, 
    File : String, 
    Line : int, 
    Column : int, 
    Condition : String, 
    ConditionType : dbgBreakpointConditionType, 
    Language : String, 
    Data : String, 
    DataCount : int, 
    Address : String, 
    HitCount : int, 
    HitCountType : dbgHitCountType
) : Breakpoints

パラメータ

Function
型 : System.String

省略可能です。関数ブレークポイント。ブレークポイントを設定する関数の名前です。

File
型 : System.String

省略可能です。ファイルブレークポイント。ブレークポイントを設定するファイルの名前とパス (省略可能) を指定します。

Line
型 : System.Int32

省略可能です。ファイルブレークポイント。ブレークポイントを設定するソースコードの行番号を指定します。行番号は関数の先頭から数えます。値が 1 の場合、ブレークポイントは関数の先頭に設定されます。

Column
型 : System.Int32

省略可能です。ファイルブレークポイント。ブレークポイントが設定されている文字です。ほとんどの場合は、この値を 1 に設定したままにできます。この場合、ブレークポイントは行の先頭に設定されます。

Condition
型 : System.String

省略可能です。ブレークポイントの Condition。ConditionType と共に使用します。

ConditionType
型 : EnvDTE.dbgBreakpointConditionType

省略可能です。条件の種類。dbgBreakpointConditionType 値。Condition と共に使用します。

Language
型 : System.String

省略可能です。関数の記述に使用されるプログラミング言語。

Data
型 : System.String

省略可能です。データブレークポイント。ブレークポイントが変数に設定されている場合は、変数名を指定できます。コンテキスト演算子 (C/C++ 言語式) を使用すると、現在のスコープ外の変数を指定できます。

DataCount
型 : System.Int32

省略可能です。データブレークポイント。ブレークポイントが変数に設定されている場合、および変数が配列または間接参照されたポインタである場合、この値はウォッチする要素の数を指定します。

Address
型 : System.String

省略可能です。アドレスブレークポイント。ブレークポイントが設定されているメモリアドレスが 10 進形式または 16 進形式で表示されます。

HitCount
型 : System.Int32

省略可能です。ブレークポイントの Hit Count プロパティ。ヒットカウントを指定しない場合、プログラムの実行はブレークポイントにヒットするたびに中断されます。ヒットカウントを指定すると、ヒット回数に達した場合だけプログラムの実行が中断されます。

HitCountType
型 : EnvDTE.dbgHitCountType

省略可能です。ヒットカウントの種類。dbgHitCountType 値。

戻り値

型 : EnvDTE.Breakpoints

Breakpoints コレクション。

解説

新しいブレークポイントを作成して有効にし、Breakpoints コレクションを返します。

このメソッドのパラメータはすべて省略できますが、以下に示す 4 つの位置の種類のうち 1 つだけを指定できます。

ブレークポイントを設定する位置の種類	使用するパラメータ
関数内。	Function
ファイル内。オプションで、ファイル内の行と列の位置を指定できます。	File、Line、および Column
データ内。オプションで、変数およびウォッチする変数の数に対して設定できます。	Data および DataCount
指定のアドレス位置。	Address

これらの位置のどの種類に対して、指定の条件が true のときにだけ中断するように、Condition と ConditionType を指定することもできます。また、指定したヒットカウントに達した場合に中断するように、HitCount と HitCountType を指定することもできます。

例

Add メソッドの使用方法を次の例に示します。

このメソッドをテストするには

ターゲットプロジェクトを開き、アドインを実行します。

public static void Add(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("Add Method 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;
    debugger.Breakpoints.Add("","Target001.cs", 13, 1, "", 
                             EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, 
                             "C#","", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone);
    debugger.Breakpoints.Add("","Target001.cs", 15, 1, "", 
                             EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, 
                             "C#","", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone);

    owp.OutputString("\nNumber of Breakpoints: " + debugger.Breakpoints.Count);
    owp.OutputString("\nEdition of the environment: " + 
                     debugger.Breakpoints.DTE.Edition);
    owp.OutputString("\nParent's Current Mode: " + 
                     debugger.Breakpoints.Parent.CurrentMode);
    owp.OutputString("\nFirst breakpoint is on line " + 
                     debugger.Breakpoints.Item(1).FileLine + ".");
    owp.OutputString("\nSecond breakpoint is on line " + 
                     debugger.Breakpoints.Item(2).FileLine + ".");
}

Shared Sub AddBreakpoint(ByRef dte As EnvDTE.DTE)
    dte.Debugger.StepInto(True)
    dte.Debugger.Breakpoints.Add("", "Target001.cs", 13, 1, "", _
                                 EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, _
                                 "C#", "", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone)
    dte.Debugger.Breakpoints.Add("", "Target001.cs", 15, 1, "", _
                                 EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, _
                                 "C#", "", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone)
End Sub