Breakpoints.Add - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

Пространство имен: 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
Необязательный компонент. Точка останова адреса. В этом окне содержится адрес памяти в десятичном или шестнадцатеричном формате, по которому задана точка останова.

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

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

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

Тип: EnvDTE.Breakpoints
Коллекция Breakpoints.

Заметки

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

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

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

Для любого из этих типов размещения необязательно поддерживать 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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Breakpoints Интерфейс

Breakpoints - члены

EnvDTE - пространство имен

Поделиться через