Breakpoints.Add メソッド

[アーティクル]
08/09/2011

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

名前空間: 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

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
)

abstract 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 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
省略可能です。データブレークポイント。ブレークポイントが変数に設定されている場合は、変数名を指定できます。コンテキスト演算子を使用すると、現在のスコープ外の変数を指定できます。

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

.NET Framework セキュリティ

直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

Breakpoints インターフェイス

EnvDTE 名前空間

次の方法で共有

Breakpoints.Add メソッド

構文

パラメーター

戻り値

解説

例

.NET Framework セキュリティ

参照

参照

その他のリソース