Breakpoints.Add (Método)

Crea y habilita un nuevo punto de interrupción.

Espacio de nombres:  EnvDTE
Ensamblado:  EnvDTE (en EnvDTE.dll)

Sintaxis

'Declaración
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

Parámetros

• Function
  Tipo: String

  Opcional. Un punto de interrupción de función. Nombre de la función en la que se establece el punto de interrupción.

• File
  Tipo: String

  Opcional. Un punto de interrupción de archivo. Nombre y ruta (opcional) del archivo en el que se establece el punto de interrupción.

• Line
  Tipo: Int32

  Opcional. Un punto de interrupción de archivo. Número de línea del código fuente, medido desde el inicio de la función, donde se establece el punto de interrupción. Si este valor es 1, el punto de interrupción se establece en el inicio de la función.

• Column
  Tipo: Int32

  Opcional. Un punto de interrupción de archivo. El carácter en el que se establece el punto de interrupción. En la mayoría de los casos, puede dejarse este valor como 1, lo cual establece el punto de interrupción en el principio de la línea.

• Condition
  Tipo: String

  Opcional. El punto de interrupción Condition. Se utiliza con ConditionType.

• ConditionType
  Tipo: EnvDTE.dbgBreakpointConditionType

  Opcional. El tipo de condición. Valor dbgBreakpointConditionType. Se utiliza con Condition.

• Language
  Tipo: String

  Opcional. El lenguaje de programación en el que está escrita la función.

• Data
  Tipo: String

  Opcional. Un punto de interrupción de datos. Si el punto de interrupción se establece en una variable, puede especificar el nombre de la variable. Puede usar el operador de contexto para especificar una variable fuera del ámbito actual.

• DataCount
  Tipo: Int32

  Opcional. Un punto de interrupción de datos. Si el punto de interrupción se establece en una variable, y si la variable es una matriz o un puntero al que se han desreferenciado, este valor especifica el número de elementos que se van a inspeccionar.

• Address
  Tipo: String

  Opcional. Un punto de interrupción de dirección. La dirección de memoria donde se establece el punto de interrupción, en formato decimal o hexadecimal.

• HitCount
  Tipo: Int32

  Opcional. La propiedad Hit Count para el punto de interrupción. Si no se especifica ningún número de llamadas, la ejecución del programa se interrumpirá cada vez que se llegue al punto de interrupción. Si se especifica un número de llamadas, la ejecución de programa sólo se interrumpirá en el número de visitas especificado.

• HitCountType
  Tipo: EnvDTE.dbgHitCountType

  Opcional. El tipo de número de llamadas. Valor dbgHitCountType.

Valor devuelto

Tipo: EnvDTE.Breakpoints
Colección de Breakpoints.

Comentarios

Crea y habilita un nuevo punto de interrupción, y devuelve una colección Breakpoints.

Todos los parámetros para este método son opcionales; sin embargo, sólo puede especificar uno de cuatro tipos de ubicación, como se describe a continuación.

Para establecer un punto de interrupción en este tipo de ubicación	Use el parámetro o los parámetros
Dentro de una función.	Function
Dentro de un archivo. Puede especificar opcionalmente la ubicación de línea y de columna dentro del archivo.	File, Line y Column
Dentro de los datos. Se puede establecer opcionalmente para las variables y el número de variables que se van a inspeccionar.	Data y DataCount
En una dirección específica.	Address

Para cualquiera de estos tipos de ubicación, puede proporcionar opcionalmente Condition y ConditionType para que sólo se interrumpa la ejecución cuando una condición especificada sea verdadera. Puede proporcionar opcionalmente HitCount e HitCountType para que se interrumpa la ejecución en el número de llamadas especificado.

Ejemplos

En el siguiente ejemplo se muestra cómo utilizar el método Add.

Para probar este método:

1. Abra el proyecto de destino y ejecute el complemento.

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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

Breakpoints Interfaz

EnvDTE (Espacio de nombres)