Breakpoints.Add(String, String, Int32, Int32, String, dbgBreakpointConditionType, String, String, Int32, String, Int32, dbgHitCountType) Método

Definição

Cria e habilita um novo ponto de interrupção.

[System.Runtime.InteropServices.DispId(4)]
public EnvDTE.Breakpoints Add (string Function = "", string File = "", int Line = 1, int Column = 1, string Condition = "", EnvDTE.dbgBreakpointConditionType ConditionType = EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, string Language = "", string Data = "", int DataCount = 1, string Address = "", int HitCount = 0, EnvDTE.dbgHitCountType HitCountType = EnvDTE.dbgHitCountType.dbgHitCountTypeNone);
[<System.Runtime.InteropServices.DispId(4)>]
abstract member Add : string * string * int * int * string * EnvDTE.dbgBreakpointConditionType * string * string * int * string * int * EnvDTE.dbgHitCountType -> EnvDTE.Breakpoints
Public Function Add (Optional Function As String = "", Optional File As String = "", Optional Line As Integer = 1, Optional Column As Integer = 1, Optional Condition As String = "", Optional ConditionType As dbgBreakpointConditionType = EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, Optional Language As String = "", Optional Data As String = "", Optional DataCount As Integer = 1, Optional Address As String = "", Optional HitCount As Integer = 0, Optional HitCountType As dbgHitCountType = EnvDTE.dbgHitCountType.dbgHitCountTypeNone) As Breakpoints

Parâmetros

Function
String

Opcional. Um ponto de interrupção de função. O nome da função na qual o ponto de interrupção está definido.

File
String

Opcional. Um ponto de interrupção de arquivo. O nome e o caminho opcional do arquivo no qual o ponto de interrupção está definido.

Line
Int32

Opcional. Um ponto de interrupção de arquivo. O número de linha de código-fonte, medido desde o início da função, no qual o ponto de interrupção está definido. Se esse valor for 1, o ponto de interrupção será definido no início da função.

Column
Int32

Opcional. Um ponto de interrupção de arquivo. O caractere no qual o ponto de interrupção é definido. Na maioria dos casos, você pode deixar esse valor definido como 1, que define o ponto de interrupção no início da linha.

Condition
String

Opcional. O ponto de interrupção Condition . Use com ConditionType.

ConditionType
dbgBreakpointConditionType

Opcional. O tipo de condição. Um valor dbgBreakpointConditionType. Use com condição.

Language
String

Opcional. A linguagem de programação na qual a função é gravada.

Data
String

Opcional. Um ponto de interrupção de dados. Se o ponto de interrupção for definido em uma variável, você poderá especificar o nome da variável. Você pode usar o operador de contexto para especificar uma variável fora do escopo atual.

DataCount
Int32

Opcional. Um ponto de interrupção de dados. Se o ponto de interrupção for definido em uma variável e se a variável for uma matriz ou um ponteiro de referência, esse valor especificará o número de elementos a serem observados.

Address
String

Opcional. Um ponto de interrupção de endereço. O endereço de memória em que o ponto de interrupção é definido, em formato decimal ou hexadecimal.

HitCount
Int32

Opcional. A Hit Count Propriedade do ponto de interrupção. Se você não especificar nenhuma contagem de acesso, a execução do programa será interrompida cada vez que o ponto de interrupção for atingido. Se você especificar uma contagem de ocorrências, a execução do programa será interrompida somente no número especificado de ocorrências.

HitCountType
dbgHitCountType

Opcional. O tipo de contagem de acesso. Um valor dbgHitCountType.

Retornos

Breakpoints

Uma coleção de Breakpoints.

Atributos

Exemplos

O exemplo a seguir demonstra como usar o Add método.

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();  

    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  

Comentários

Cria e habilita um novo ponto de interrupção e retorna uma Breakpoints coleção.

Todos os parâmetros para esse método são opcionais; no entanto, você pode especificar apenas um dos quatro tipos de local, conforme descrito abaixo.

Para definir um ponto de interrupção neste tipo de local Usar parâmetro (s)
Dentro de uma função. Function
Dentro de um arquivo. Opcionalmente, pode especificar o local da linha e da coluna dentro do arquivo. File, Line, e Column
Nos dados. Opcionalmente, pode ser definido para variáveis e o número de variáveis a serem inspecionadas. Data e DataCount
Em um endereço específico. Address

Para qualquer um desses tipos de local, você pode opcionalmente fornecer Condition e ConditionType quebrar somente quando uma condição especificada for verdadeira. Opcionalmente, você pode fornecer HitCount e HitCountType quebrar na contagem de acesso especificada.

Aplica-se a