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, что задает точку останова в начале строки.
- ConditionType
- dbgBreakpointConditionType
Необязательный параметр. Условие типа. Значение dbgBreakpointConditionType. Использовать с условием.
- Language
- String
Необязательный параметр. Язык программирования, на котором написана функция.
- Data
- String
Необязательный параметр. Точка останова по данным. Если точка останова по данным установлена для переменной, можно задать имя переменной. Можно использовать контекстный оператор для задания переменной вне текущей области видимости.
- DataCount
- Int32
Необязательный параметр. Точка останова по данным. Если точка останова по данным установлена для переменной, и переменная является массивом или указателем со снятой ссылкой, это значение указывает на наблюдаемое количество элементов.
- Address
- String
Необязательный параметр. Точка останова адреса. В этом окне содержится адрес памяти в десятичном или шестнадцатеричном формате, по которому задана точка останова.
- HitCount
- Int32
Необязательный параметр. Свойство Hit Count для точки останова. Если свойство «Число попаданий» для точки останова не задано, то выполнение программы будет прерываться каждый раз при попадании на точку останова. Если свойство «Число попаданий» для точки останова задано, то выполнение программы будет прерываться только на заданном числе попаданий.
- HitCountType
- dbgHitCountType
Необязательный параметр. Тип счетчика числа попаданий. Значение dbgHitCountType.
Возвращаемое значение
Коллекция 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 прервать указанное число попаданий.