Breakpoints.Add - метод

Статья
11/01/2012

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

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

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

Breakpoints Интерфейс

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

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