Breakpoints.Add(String, String, Int32, Int32, String, dbgBreakpointConditionType, String, String, Int32, String, Int32, dbgHitCountType) Methode

Definition

Erstellt und aktiviert einen neuen Haltepunkt.

[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

Parameter

Function
String

(Optional) Ein Funktions-Haltepunkt. Der Namen der Funktion, in der der Haltepunkt gesetzt ist.

File
String

(Optional) Ein Datei-Haltepunkt. Der Name und optional der Pfad der Datei, in der der Haltepunkt gesetzt ist.

Line
Int32

(Optional) Ein Datei-Haltepunkt. Die Zeilennummer im Quellcode, gemessen ab dem Beginn der Funktion, in der der Haltepunkt gesetzt ist. Wenn dieser Wert gleich 1 ist, dann ist der Haltepunkt am Anfang der Funktion gesetzt.

Column
Int32

(Optional) Ein Datei-Haltepunkt. Das Zeichen, an dem der Haltepunkt gesetzt ist. In den meisten Fällen können Sie diesen Wert auf 1 belassen, um den Haltepunkt am Anfang der Zeile zu setzen.

Condition
String

(Optional) Die Condition des Haltepunkts. Verwenden Sie mit ConditionType.

ConditionType
dbgBreakpointConditionType

(Optional) Der Bedingungstyp. Ein dbgBreakpointConditionType-Wert. Verwenden Sie with Condition.

Language
String

(Optional) Die Programmiersprache, in der die Funktion geschrieben ist.

Data
String

(Optional) Ein Daten-Haltepunkt. Wenn der Haltepunkt auf einer Variablen gesetzt ist, können Sie den Namen der Variable angeben. Sie können den Kontext-Operator verwenden, um eine Variable außerhalb des aktuellen Bereichs anzugeben.

DataCount
Int32

(Optional) Ein Daten-Haltepunkt. Wenn der Haltepunkt auf einer Variablen gesetzt ist und die Variable ein Array oder ein dereferenzierter Zeiger ist, dann gibt dieser Wert die Anzahl der zu überwachenden Elemente an.

Address
String

(Optional) Ein Adressen-Haltepunkt. Die Speicheradresse, an der der Haltepunkt gesetzt ist, im Dezimal- oder im Hexadezimalformat.

HitCount
Int32

(Optional) Die Hit Count-Eigenschaft für den Haltepunkt. Wenn Sie keine Trefferanzahl angeben, dann wird die Ausführung bei jedem Erreichen des Haltepunkts unterbrochen. Wenn Sie eine Trefferanzahl angeben, dann wird die Ausführung nur für die angegebene Anzahl von Treffern unterbrochen.

HitCountType
dbgHitCountType

(Optional) Der Trefferanzahl-Typ. Ein dbgHitCountType-Wert.

Gibt zurück

Breakpoints

Eine Breakpoints-Auflistung.

Attribute

Beispiele

Im folgenden Beispiel wird die Verwendung der Add-Methode veranschaulicht.

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  

Hinweise

Erstellt und aktiviert einen neuen Breakpoint und gibt eine Auflistung zurück Breakpoints .

Alle Parameter für diese Methode sind optional. Sie können jedoch nur einen von vier Standort Typen angeben, wie unten beschrieben.

So legen Sie einen Haltepunkt in diesem Speicherort fest Parameter verwenden
Innerhalb einer Funktion. Function
In einer Datei. Kann optional die Zeilen-und Spaltenposition innerhalb der Datei angeben. File, Line und Column
Innerhalb von Daten. Kann optional für Variablen und die Anzahl der zu überwachenden Variablen festgelegt werden. Data und DataCount
An einer bestimmten Adresse. Address

An einen dieser Speicherort Typen können Sie optional und angeben Condition , ConditionType um nur zu unterbrechen, wenn eine angegebene Bedingung erfüllt ist. Sie können optional HitCount und angeben HitCountType , um die angegebene Treffer Anzahl zu unterbrechen.

Gilt für