Metodo Breakpoints.Add

Articolo
10/30/2012

Crea e consente un nuovo punto di interruzione.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

Function
Tipo: System.String
facoltativo.un punto di interruzione di funzione.Il nome della funzione su cui è impostato il punto di interruzione.

File
Tipo: System.String
facoltativo.Un punto di interruzione di file.Il nome e il percorso facoltativo del file in cui è impostato il punto di interruzione.

Line
Tipo: System.Int32
facoltativo.Un punto di interruzione di file.Il numero di riga di codice sorgente, misurato dall'inizio della funzione, a cui è impostato il punto di interruzione.Se questo valore è 1, il punto di interruzione viene impostato all'inizio della funzione.

Column
Tipo: System.Int32
facoltativo.Un punto di interruzione di file.Il carattere in cui è impostato il punto di interruzione.Nella maggior parte dei casi, è possibile lasciare questo valore impostato su 1, che imposta il punto di interruzione all'inizio della riga.

Condition
Tipo: System.String
facoltativo.il punto di interruzione Condition.L'utilizzo con ConditionType.

ConditionType
Tipo: EnvDTE.dbgBreakpointConditionType
facoltativo.Il tipo di condizione.In dbgBreakpointConditionType valore.L'utilizzo con Condition.

Language
Tipo: System.String
facoltativo.Il linguaggio di programmazione in cui la funzione viene scritta.

Data
Tipo: System.String
facoltativo.Un punto di interruzione dei dati.Se il punto di interruzione viene impostato su una variabile, è possibile specificare il nome della variabile.È possibile utilizzare l'operatore di contesto per specificare una variabileambito corrente.

DataCount
Tipo: System.Int32
facoltativo.Un punto di interruzione dei dati.Se il punto di interruzione viene impostato su una variabile e se la variabile è una matrice o un puntatore derefenziato, questo valore viene specificato il numero di elementi da controllare.

Address
Tipo: System.String
facoltativo.un punto di interruzione di indirizzo.L'indirizzo di memoria in cui è impostato il punto di interruzione, decimale o in formato esadecimale.

HitCount
Tipo: System.Int32
facoltativo. Hit Count proprietà del punto di interruzione.Se non si specifica numero di passaggi, l'esecuzione del programma si interrompe ogni qualvolta viene raggiunto il punto di interruzione.Se si specifica un numero di passaggi, l'esecuzione del programma si interrompe solo sul numero specificato di richieste soddisfatte.

HitCountType
Tipo: EnvDTE.dbgHitCountType
facoltativo.il tipo di numero di passaggi.In dbgHitCountType valore.

Valore restituito

Tipo: EnvDTE.Breakpoints
In Breakpoints raccolta.

Note

Crea e consente un nuovo punto di interruzione e restituisce un valore Breakpoints raccolta.

Tutti i parametri di questo metodo sono facoltativi, tuttavia è possibile specificare solo uno dei quattro tipi di posizione, come descritto di seguito.

Per impostare un punto di interruzione in questo tipo di percorso	parametri di utilizzo
All'interno di una funzione.	Function
All'interno di un file.È possibile specificare la posizione di riga nel file.	File, Linee Column
All'interno dei dati.Facoltativamente può essere impostato per le variabili e il numero di variabili per controllare.	Data e DataCount
A un indirizzo specifico.	Address

In uno di questi tipi di posizione, è possibile fornire facoltativamente Condition e ConditionType per interrompere solo quando una condizione specificata è vera.È possibile fornire HitCount e HitCountType per interrompere il numero di passaggi specificato.

Esempi

Nell'esempio seguente viene illustrato come utilizzare Add metodo.

Per testare questo metodo:

Aprire il progetto di destinazione ed eseguire il componente aggiuntivo.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Breakpoints Interfaccia

Spazio dei nomi EnvDTE

Share via