Metodo Breakpoints.Add
Crea e attiva 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.Punto di interruzione di una funzione.Nome della funzione su cui è impostato il punto di interruzione.
- File
Tipo: System.String
Facoltativo.Punto di interruzione di un file.Il nome, ed eventualmente il percorso, del file in cui è impostato il punto di interruzione.
- Line
Tipo: System.Int32
Facoltativo.Punto di interruzione di un file.Numero di riga del codice sorgente, misurato dall'inizio del file, sul quale è impostato il punto di interruzione.Se questo valore è 1, il punto di interruzione verrà impostato all'inizio della funzione.
- Column
Tipo: System.Int32
Facoltativo.Punto di interruzione di un file.Carattere sul quale è impostato il punto di interruzione.Nella maggior parte dei casi è possibile mantenere questo valore impostato su 1, in modo da collocare il punto di interruzione all'inizio della riga.
- Condition
Tipo: System.String
Facoltativo.Punto di interruzione Condition.Utilizzare con ConditionType.
- ConditionType
Tipo: EnvDTE.dbgBreakpointConditionType
Facoltativo.Tipo di condizione.Valore di dbgBreakpointConditionType.Utilizzare con Condition.
- Language
Tipo: System.String
Facoltativo.Linguaggio di programmazione in cui è stata scritta la funzione.
- Data
Tipo: System.String
Facoltativo.Punto di interruzione di dati.Se il punto di interruzione è impostato su una variabile, è possibile specificare il nome della variabile.È possibile utilizzare l'operatore di contesto per specificare una variabile non compresa nell'ambito corrente.
- DataCount
Tipo: System.Int32
Facoltativo.Punto di interruzione di dati.Se il punto di interruzione è impostato su una variabile, e se la variabile è una matrice o un puntatore senza riferimenti, questo valore specifica il numero di elementi da controllare.
- Address
Tipo: System.String
Facoltativo.Punto di interruzione di un indirizzo.Indirizzo di memoria sul quale è impostato il punto di interruzione, in formato decimale o esadecimale.
- HitCount
Tipo: System.Int32
Facoltativo.Proprietà Hit Count per il punto di interruzione.Se non si specifica un numero di passaggi, l'esecuzione del programma viene interrotta ogni volta che viene incontrato il punto di interruzione.Se si specifica un numero di passaggi, l'esecuzione del programma viene interrotta solo quando viene raggiunto il numero di passaggi specificato.
- HitCountType
Tipo: EnvDTE.dbgHitCountType
Facoltativo.Tipo del numero di passaggi.Valore di dbgHitCountType.
Valore restituito
Tipo: EnvDTE.Breakpoints
Insieme di Breakpoints.
Note
Crea e attiva un nuovo punto di interruzione e restituisce un insieme Breakpoints.
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 posizione |
Utilizzare il parametro o i parametri |
|---|---|
All'interno di una funzione. |
Function |
All'interno di un file. Facoltativamente è possibile specificare la riga e la colonna nel file. |
File, Line e Column |
All'interno di dati. Può essere impostato facoltativamente per variabili e per il numero di variabili da controllare. |
Data e DataCount |
In corrispondenza di un indirizzo specifico. |
Address |
Per questi tipi di posizione è possibile specificare, facoltativamente, Condition e ConditionType per interrompere l'esecuzione solo se una condizione specificata è vera. È possibile specificare, facoltativamente, HitCount e HitCountType per interrompere l'esecuzione al numero di passaggi specificato.
Esempi
Nell'esempio riportato di seguito viene illustrato come utilizzare il metodo Add.
Per verificare il 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.