Breakpoints.Add(String, String, Int32, Int32, String, dbgBreakpointConditionType, String, String, Int32, String, Int32, dbgHitCountType) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
- 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
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.