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

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 die Verwendung der Add-Methode.

So testen Sie diese Methode

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

Siehe auch

Referenz

Breakpoints Schnittstelle

EnvDTE-Namespace