Partager via


Breakpoints.Add, méthode

Crée et active un nouveau point d'arrêt.

Espace de noms :  EnvDTE
Assembly :  EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
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

Paramètres

  • Function
    Type : System.String
    Facultatif.Point d'arrêt sur fonction.Le nom de la fonction au niveau duquel le point d'arrêt est défini.
  • File
    Type : System.String
    Facultatif.Point d'arrêt sur fichier.Le nom et le chemin d'accès facultatif du fichier dans lequel le point d'arrêt est défini.
  • Line
    Type : System.Int32
    Facultatif.Point d'arrêt sur fichier.Le numéro de la ligne de code source, mesuré depuis le début de la fonction, au niveau de laquelle le point d'arrêt est défini.Si cette valeur est 1, le point d'arrêt est défini au début de la fonction.
  • Column
    Type : System.Int32
    Facultatif.Point d'arrêt sur fichier.Caractère attribué comme valeur au point d'arrêt.Dans la plupart des cas, vous pouvez conserver la valeur 1, qui a pour effet de définir le point d'arrêt au début de la ligne.
  • Language
    Type : System.String
    Facultatif.Langage de programmation dans lequel la fonction est écrite.
  • Data
    Type : System.String
    Facultatif.Point d'arrêt sur variable.Si la valeur du point d'arrêt est une variable, vous pouvez spécifier le nom de cette variable.Vous pouvez utiliser l'opérateur de contexte pour spécifier une variable située hors de la portée actuelle.
  • DataCount
    Type : System.Int32
    Facultatif.Point d'arrêt sur variable.Si la valeur du point d'arrêt est une variable et si cette variable est un tableau ou un pointeur déréférencé, cette valeur spécifie le nombre d'éléments à surveiller.
  • Address
    Type : System.String
    Facultatif.Point d'arrêt sur adresse mémoire.L'adresse mémoire dans laquelle le point d'arrêt est défini, en format décimal ou hexadécimal.
  • HitCount
    Type : System.Int32
    Facultatif.Propriété Hit Count du point d'arrêt.Si vous ne spécifiez aucun nombre d'accès, l'exécution du programme s'arrête chaque fois que le point d'arrêt est atteint.Si vous spécifiez un nombre d'accès, l'exécution du programme s'arrête uniquement sur le nombre d'accès spécifié.

Valeur de retour

Type : EnvDTE.Breakpoints
Collection Breakpoints.

Notes

Crée et active un nouveau point d'arrêt et retourne une collection Breakpoints.

Tous les paramètres de cette méthode sont facultatifs ; toutefois, vous pouvez spécifier un des quatre types d'emplacement, comme décrit au-dessous.

Pour définir un point d'arrêt dans ce type d'emplacement

Utilisez un ou plusieurs paramètre(s)

Dans une fonction.

Function

Dans un fichier.Peut spécifier l'emplacement de la ligne et de la colonne dans le fichier.

File, Line et Column

Dans les données.Peut être défini pour les variables et le nombre de variables à surveiller.

Data et DataCount

À une adresse spécifique.

Address

Vous pouvez éventuellement fournir à chacun de ces types d'emplacement Condition et ConditionType à arrêter uniquement lorsqu'une condition spécifiée a la valeur true.Vous pouvez éventuellement fournir HitCount et HitCountType à arrêter sur le nombre d'accès spécifié.

Exemples

L'exemple suivant montre comment utiliser la méthode Add.

Pour tester cette méthode :

  1. Ouvrez le projet cible et exécutez le complément.
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

Sécurité .NET Framework

Voir aussi

Référence

Breakpoints Interface

EnvDTE, espace de noms