Breakpoints.Add-Methode
Aktualisiert: November 2007
Erstellt und aktiviert einen neuen Haltepunkt.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Syntax
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
Dim instance As Breakpoints
Dim Function As String
Dim File As String
Dim Line As Integer
Dim Column As Integer
Dim Condition As String
Dim ConditionType As dbgBreakpointConditionType
Dim Language As String
Dim Data As String
Dim DataCount As Integer
Dim Address As String
Dim HitCount As Integer
Dim HitCountType As dbgHitCountType
Dim returnValue As Breakpoints
returnValue = instance.Add(Function, File, _
Line, Column, Condition, ConditionType, _
Language, Data, DataCount, Address, _
HitCount, HitCountType)
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
)
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.StringOptional. Ein Funktionshaltepunkt. Der Name der Funktion, in der der Haltepunkt gesetzt wird.
File
Typ: System.StringOptional. Ein Dateihaltepunkt. Der Name und optional auch der Pfad der Datei, in der der Haltepunkt gesetzt wurde.
Line
Typ: System.Int32Optional. 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.Int32Optional. 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.StringOptional. Der Haltepunkt Condition. Mit ConditionType zu verwenden.
ConditionType
Typ: EnvDTE.dbgBreakpointConditionTypeOptional. Der Bedingungstyp. Ein dbgBreakpointConditionType-Wert. Mit Condition zu verwenden.
Language
Typ: System.StringOptional. Die Programmiersprache, in der die Funktion geschrieben wurde.
Data
Typ: System.StringOptional. Ein Datenhaltepunkt. Wenn der Haltepunkt in einer Variablen festgelegt wird, können Sie den Namen der Variablen angeben. Mit Kontextoperator (Ausdrücke der Sprache C/C++) können Sie eine Variable außerhalb des aktuellen Gültigkeitsbereichs festlegen.
DataCount
Typ: System.Int32Optional. 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.StringOptional. Ein Adresshaltepunkt. Die Speicheradresse, an der der Haltepunkt festgelegt wird, im Dezimal- oder Hexadezimalformat.
HitCount
Typ: System.Int32Optional. 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.dbgHitCountTypeOptional. 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
Berechtigungen
- 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.