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 : String

  Optionnel. Point d'arrêt sur fonction. Le nom de la fonction au niveau duquel le point d'arrêt est défini.

• File
  Type : String

  Optionnel. 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 : Int32

  Optionnel. 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 : Int32

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

• Condition
  Type : String

  Optionnel. Point d'arrêt Condition. Utilisez avec ConditionType.

• ConditionType
  Type : EnvDTE.dbgBreakpointConditionType

  Optionnel. Type de condition. Valeur dbgBreakpointConditionType. Utilisez avec Condition.

• Language
  Type : String

  Optionnel. Langage de programmation dans lequel la fonction est écrite.

• Data
  Type : String

  Optionnel. 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 : Int32

  Optionnel. 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 : String

  Optionnel. 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 : Int32

  Optionnel. 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é.

• HitCountType
  Type : EnvDTE.dbgHitCountType

  Optionnel. Type de nombre d'accès. Valeur dbgHitCountType.

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

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

Breakpoints Interface

EnvDTE, espace de noms