Breakpoints.Add(String, String, Int32, Int32, String, dbgBreakpointConditionType, String, String, Int32, String, Int32, dbgHitCountType) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
- 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
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.