Breakpoints.Add-Methode

Artikel
10/24/2012

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

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.

Siehe auch

Referenz

Breakpoints Schnittstelle

EnvDTE-Namespace

Freigeben über