Breakpoints.Add-Methode
Erstellt und aktiviert einen neuen Haltepunkt.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Syntax
'Declaration
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
Parameter
- Function
Typ: System.String
Optional.Ein Funktionshaltepunkt.Der Name der Funktion, in der der Haltepunkt gesetzt wird.
- File
Typ: System.String
Optional.Ein Dateihaltepunkt.Der Name und optional auch der Pfad der Datei, in der der Haltepunkt gesetzt wurde.
- Line
Typ: System.Int32
Optional.Ein Dateihaltepunkt.Die Zeilennummer im Quellcode, ausgehend vom Beginn der Funktion, in der der Haltepunkt gesetzt wurde.Wenn dieser Wert 1 ist, wird der Haltepunkt am Anfang der Funktion gesetzt.
- Column
Typ: System.Int32
Optional.Ein Dateihaltepunkt.Das Zeichen, an dem der Haltepunkt gesetzt wird.In den meisten Fällen können Sie diesen Wert bei 1 belassen, wodurch der Haltepunkt am Anfang der Zeile gesetzt wird.
- Condition
Typ: System.String
Optional.Der Haltepunkt Condition.Mit ConditionType zu verwenden.
- ConditionType
Typ: EnvDTE.dbgBreakpointConditionType
Optional.Der Bedingungstyp.Ein dbgBreakpointConditionType-Wert.Mit Condition zu verwenden.
- Language
Typ: System.String
Optional.Die Programmiersprache, in der die Funktion geschrieben wurde.
- Data
Typ: System.String
Optional.Ein Datenhaltepunkt.Wenn der Haltepunkt in einer Variablen festgelegt wird, können Sie den Namen der Variablen angeben.Mit dem Kontextoperator können Sie eine Variable außerhalb des aktuellen Bereichs festlegen.
- DataCount
Typ: System.Int32
Optional.Ein Datenhaltepunkt.Wenn der Haltepunkt in einer Variablen festgelegt wird und die Variable ein Array oder ein dereferenzierter Zeiger ist, gibt dieser Wert die Anzahl der zu überwachenden Elemente an.
- Address
Typ: System.String
Optional.Ein Adresshaltepunkt.Die Speicheradresse, an der der Haltepunkt festgelegt wird, im Dezimal- oder Hexadezimalformat.
- HitCount
Typ: System.Int32
Optional.Die Hit Count-Eigenschaft für den Haltepunkt.Wenn Sie keine Trefferanzahl angeben, wird die Programmausführung jedes Mal unterbrochen, wenn der Haltepunkt erreicht wird.Wenn Sie jedoch eine Trefferanzahl angeben, wird die Programmausführung nur bei der angegebenen Anzahl von Treffern unterbrochen.
- HitCountType
Typ: EnvDTE.dbgHitCountType
Optional.Der Trefferanzahltyp.Ein dbgHitCountType-Wert.
Rückgabewert
Typ: EnvDTE.Breakpoints
Eine Breakpoints-Auflistung.
Hinweise
Erstellt und aktiviert einen neuen Haltepunkt und gibt eine Breakpoints-Auflistung zurück.
Alle Parameter für diese Methode sind optional, es kann jedoch nur einer von vier Positionstypen angegeben werden, wie unten beschrieben.
So legen Sie einen Haltepunkt an dieser Position fest |
Zu verwendende(r) Parameter |
|---|---|
Innerhalb einer Funktion. |
Function |
Innerhalb einer Datei. Kann optinal 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 |
Bei Verwendung eines dieser Positionstypen können Sie optional Condition und ConditionType angeben, um die Ausführung nur dann zu unterbrechen, wenn eine bestimmte Bedingung zutrifft. Sie können optional HitCount und HitCountType angeben, um die Ausführung bei Erreichen der angegebenen Trefferanzahl zu unterbrechen.
Beispiele
Das folgende Beispiel veranschaulicht, wie die Add-Methode verwendet wird.
So testen Sie diese Methode
- Öffnen Sie das Zielprojekt, und führen Sie das Add-In aus.
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-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.