Breakpoints.Add(String, String, Int32, Int32, String, dbgBreakpointConditionType, String, String, Int32, String, Int32, dbgHitCountType) Метод

Определение

Создайте и сделайте доступной новую точку останова.

[System.Runtime.InteropServices.DispId(4)]
public EnvDTE.Breakpoints Add (string Function = "", string File = "", int Line = 1, int Column = 1, string Condition = "", EnvDTE.dbgBreakpointConditionType ConditionType = EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, string Language = "", string Data = "", int DataCount = 1, string Address = "", int HitCount = 0, EnvDTE.dbgHitCountType HitCountType = EnvDTE.dbgHitCountType.dbgHitCountTypeNone);
[<System.Runtime.InteropServices.DispId(4)>]
abstract member Add : string * string * int * int * string * EnvDTE.dbgBreakpointConditionType * string * string * int * string * int * EnvDTE.dbgHitCountType -> EnvDTE.Breakpoints
Public Function Add (Optional Function As String = "", Optional File As String = "", Optional Line As Integer = 1, Optional Column As Integer = 1, Optional Condition As String = "", Optional ConditionType As dbgBreakpointConditionType = EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, Optional Language As String = "", Optional Data As String = "", Optional DataCount As Integer = 1, Optional Address As String = "", Optional HitCount As Integer = 0, Optional HitCountType As dbgHitCountType = EnvDTE.dbgHitCountType.dbgHitCountTypeNone) As Breakpoints

Параметры

Function
String

Необязательный параметр. Точка останова функции. Имя функции, в которой задана точка останова.

File
String

Необязательный параметр. Точка останова в файле. Имя и путь (необязателен) файла, в котором задана точка останова.

Line
Int32

Необязательный параметр. Точка останова в файле. Номер строки в исходном коде, отсчитываемый от начала функции, в которой задана точка останова. Если это значение равно 1, точка останова ставится в начале функции.

Column
Int32

Необязательный параметр. Точка останова в файле. Символ, на котором задана точка останова. В большинстве случаев можно оставлять это значение равным 1, что задает точку останова в начале строки.

Condition
String

Необязательный параметр. Точка останова Condition. Используйте с исключением.

ConditionType
dbgBreakpointConditionType

Необязательный параметр. Условие типа. Значение dbgBreakpointConditionType. Использовать с условием.

Language
String

Необязательный параметр. Язык программирования, на котором написана функция.

Data
String

Необязательный параметр. Точка останова по данным. Если точка останова по данным установлена для переменной, можно задать имя переменной. Можно использовать контекстный оператор для задания переменной вне текущей области видимости.

DataCount
Int32

Необязательный параметр. Точка останова по данным. Если точка останова по данным установлена для переменной, и переменная является массивом или указателем со снятой ссылкой, это значение указывает на наблюдаемое количество элементов.

Address
String

Необязательный параметр. Точка останова адреса. В этом окне содержится адрес памяти в десятичном или шестнадцатеричном формате, по которому задана точка останова.

HitCount
Int32

Необязательный параметр. Свойство Hit Count для точки останова. Если свойство «Число попаданий» для точки останова не задано, то выполнение программы будет прерываться каждый раз при попадании на точку останова. Если свойство «Число попаданий» для точки останова задано, то выполнение программы будет прерываться только на заданном числе попаданий.

HitCountType
dbgHitCountType

Необязательный параметр. Тип счетчика числа попаданий. Значение dbgHitCountType.

Возвращаемое значение

Breakpoints

Коллекция Breakpoints.

Атрибуты

Примеры

В следующем примере показано использование метода 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();  

    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  

Комментарии

Создает и включает новую точку останова и возвращает Breakpoints коллекцию.

Все параметры этого метода являются необязательными; Однако можно указать только один из четырех типов расположения, как описано ниже.

Задание точки останова в этом типе расположения Использовать параметры
Внутри функции. Function
В файле. При необходимости можно указать строку и расположение столбца в файле. File, Line и Column.
В пределах данных. При необходимости можно задать переменные и количество наблюдаемых переменных. Data и DataCount
По указанному адресу. Address

Для любого из этих типов расположения при необходимости можно указать Condition и ConditionType для прерывания только в случае, если заданное условие истинно. При необходимости можно указать HitCount и HitCountType прервать указанное число попаданий.

Применяется к