Metoda Breakpoints.Add —

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ę:

1. 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