Metoda Breakpoints.Add —

Artykuł
05/17/2015

Tworzy i umożliwia nowy punkt przerwania.

Przestrzeń nazw: EnvDTE
Zestaw: EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
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

Parametry

Function
Typ: String

Opcjonalne.Funkcja punkt przerwania.Nazwa funkcji, na którym jest ustawiony punkt przerwania.

File
Typ: String

Opcjonalne.Przerwania pliku.Nazwę i opcjonalnie ścieżkę pliku, w którym jest ustawiony punkt przerwania.

Line
Typ: Int32

Opcjonalne.Przerwania pliku.Numer wiersza kodu źródłowego, mierzony od początku funkcji, na którym jest ustawiony punkt przerwania.Jeśli ta wartość wynosi 1, punkt przerwania ustawiono na początku funkcji.

Column
Typ: Int32

Opcjonalne.Przerwania pliku.Znak, na którym jest ustawiony punkt przerwania.W większości przypadków można pozostawić tę wartość, wartość 1, który ustawia punkt przerwania na początku wiersza.

Condition
Typ: String

Opcjonalne.Punkt przerwania Condition.Use with ConditionType.

ConditionType
Typ: EnvDTE.dbgBreakpointConditionType

Opcjonalne.Typ warunku.A dbgBreakpointConditionType value.Use with Condition.

Language
Typ: String

Opcjonalne.Język programowania, w którym napisano funkcji.

Data
Typ: String

Opcjonalne.Przerwania danych.Jeśli punkt przerwania ustawiono na zmienną, można określić nazwę zmiennej.Określenie zmiennej spoza bieżącego zakresu, można użyć operatora kontekstu.

DataCount
Typ: Int32

Opcjonalne.Przerwania danych.Jeśli punkt przerwania jest ustawiona w zmiennej i zmienna jest tablicą lub wskaźnik dereferenced, wartość ta określa liczbę elementów do oglądania.

Address
Typ: String

Opcjonalne.Adres punktu przerwania.Adres pamięci, gdzie ustaw punkt przerwania w formacie dziesiętnym lub szesnastkowym.

HitCount
Typ: Int32

Opcjonalne.Hit Count Właściwość punkt przerwania.Jeśli określisz nie licznika trafień, wykonywanie programów podziały każdorazowo hit jest punkt przerwania.Jeśli określisz licznika trafień, tylko na określoną liczbę trafień powoduje przerwanie wykonywania programu.

HitCountType
Typ: EnvDTE.dbgHitCountType

Opcjonalne.Typ licznika trafień.A dbgHitCountType value.

Wartość zwracana

Typ: EnvDTE.Breakpoints
A Breakpoints kolekcji.

Uwagi

Tworzy nowy punkt przerwania pozwala i zwraca Breakpoints kolekcji.

Wszystkie parametry dla tej metody są opcjonalne; Jednakże można określić tylko jeden z czterech typów lokalizacji, jak opisano poniżej.

Aby ustawić punkt przerwania w tego typu lokalizacji	Użyj parametrów
W obrębie danej funkcji.	Function
W pliku.Opcjonalnie można określić lokalizację wiersza i kolumny w pliku.	File, Line, andColumn
W ramach danych.Można opcjonalnie ustawić zmienne i liczby zmiennych do oglądania.	DataiDataCount
Pod określonym adresem.	Address

Do dowolnego z tych typów lokalizacji, można opcjonalnie dostaw Condition i ConditionType do złamania, tylko wtedy, gdy określony warunek jest spełniony.Opcjonalnie można podać HitCount i HitCountType do dzielenia na określonego licznika trafień.

Przykłady

Poniższy przykład demonstruje, jak używać Add metody.

Aby przetestować tę metodę:

Otwórz docelowy projekt i uruchomić dodatku.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

Breakpoints Interfejs

Przestrzeń nazw EnvDTE

Udostępnij za pośrednictwem