共用方式為

Breakpoints.Add 方法

  • 發行項

建立和啟用新中斷點。

命名空間：  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
    類型：String

    選擇項。 函式中斷點。 用來設定中斷點的函式名稱。

  • File
    類型：String

    選擇項。 檔案中斷點。 設有中斷點的檔案名稱和選擇性檔案路徑。

  • Line
    類型：Int32

    選擇項。 檔案中斷點。 設定中斷點的原始程式碼行號，從函式開頭起算。 如果這項值為 1，中斷點會設定在函式的開頭。

  • Column
    類型：Int32

    選擇項。 檔案中斷點。 設定中斷點的字元。 在大多數情況下，您可以讓這項值設定為 1，將中斷點設定在行的開頭。

  • Condition
    類型：String

    選擇項。 Condition 中斷點。 與 ConditionType 一起使用。

  • Language
    類型：String

    選擇項。 撰寫函式的程式設計語言。

  • Data
    類型：String

    選擇項。 資料中斷點。 如果在某變數上設定中斷點，您可以指定這個變數的名稱。 您可以使用內容運算子指定目前範圍之外的變數。

  • DataCount
    類型：Int32

    選擇項。 資料中斷點。 如果在某變數上設定中斷點，且這個變數是陣列或解除參考的指標，這個值則會指定要監看的元素數目。

  • Address
    類型：String

    選擇項。 位址中斷點。 設定中斷點的記憶位址是十進位或十六進位。

  • HitCount
    類型：Int32

    選擇項。 中斷點的 Hit Count 屬性。 如果您沒有指定叫用次數 (Hit Count)，程式執行會在每次叫用中斷點時中斷。 如果您指定叫用次數，程式執行只會在指定的叫用數中斷。

傳回值

類型：EnvDTE.Breakpoints
Breakpoints 集合。

備註

建立並啟用新的中斷點，然後傳回 Breakpoints 集合。

這個方法的所有參數都是選擇性的；然而，您只能指定下述四種位置類型中的其中一種。

若要在這個位置類型設定中斷點

使用參數

在函式內。

Function

在檔案內。 可以選擇性的在檔案內指定列與行的位置。

File、Line 和 Column

在資料內。 可以選擇性的為變數和要監看的變數數量做設定。

Data 和 DataCount

在特定位址。

Address

僅在指定條件成立時，您才可以對任何這種位置類型選擇性的提供 Condition 和 ConditionType 進行中斷。 您可以在指定叫用次數，選擇性的提供 HitCount 和 HitCountType 進行中斷。

範例

下列範例示範如何使用 Add 方法。

若要測試這個方法：

  1. 開啟目標專案並執行增益集。
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 命名空間