Método Breakpoints.Add

Artigo
08/01/2011

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

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
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: System.String
Opcional.Um ponto de interrupção de função.O nome da função em que o ponto de interrupção está definido.

File
Tipo: System.String
Opcional.Um ponto de interrupção do arquivo.O nome e opcional o caminho do arquivo no qual o ponto de interrupção é definido.

Line
Tipo: System.Int32
Opcional.Um ponto de interrupção do arquivo.O número da linha de código-fonte, medido a partir do início da função, qual o ponto de interrupção está definido.Se esse valor for 1, o ponto de interrupção é definido no início da função.

Column
Tipo: System.Int32
Opcional.Um ponto de interrupção do 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
Tipo: System.String
Opcional.O ponto de interrupção Condition.Use com ConditionType.

ConditionType
Tipo: EnvDTE.dbgBreakpointConditionType
Opcional.O tipo de condição.Um valor dbgBreakpointConditionType.Use com Condition.

Language
Tipo: System.String
Opcional.A linguagem de programação em que a função é escrita.

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

DataCount
Tipo: System.Int32
Opcional.Um ponto de interrupção de dados.Se o ponto de interrupção é definido em uma variável e se a variável for uma matriz ou um ponteiro dereferenced, esse valor Especifica o número de elementos para assistir.

Address
Tipo: System.String
Opcional.Um ponto de interrupção de endereço.O endereço de memória onde o ponto de interrupção é definido no formato decimal ou hexadecimal.

HitCount
Tipo: System.Int32
Opcional.O Hit Count a propriedade para o ponto de interrupção.Se você especificar sem contagem de ocorrências, a execução do programa quebras cada vez que o ponto de interrupção é atingido.Se você especificar uma contagem de ocorrências, quebras de execução do programa apenas no número especificado de ocorrências.

HitCountType
Tipo: EnvDTE.dbgHitCountType
Opcional.O tipo de contagem de ocorrências.Um valor dbgHitCountType.

Valor de retorno

Tipo: EnvDTE.Breakpoints
A Breakpoints coleção.

Comentários

Cria e permite que um novo ponto de interrupção e retorna um Breakpoints coleção.

Todos os parâmetros desse método são opcionais. No entanto, você pode especificar somente um dos quatro tipos de local, conforme descrito abaixo.

Para definir um ponto de interrupção nesse tipo de local	Use o parâmetro (s)
Dentro de uma função.	Function
Dentro de um arquivo. Opcionalmente, pode especificar o local de linha e coluna dentro do arquivo.	File[Line, e Column.
Dentro de dados. Pode, opcionalmente, ser definida para variáveis e o número de variáveis para assistir.	Data e DataCount
Em um endereço específico.	Address

Para qualquer um desses tipos de local, você pode fornecer, opcionalmente, Condition e ConditionType para quebrar somente quando uma condição especificada é true. Opcionalmente, você pode fornecer HitCount e HitCountType para interromper a contagem de visitas especificado.

Exemplos

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

Para testar esse método:

Abra o projeto de destino e execute o add-in.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Breakpoints Interface

Namespace EnvDTE

Compartilhar via