Propriedade Breakpoint.Condition

Artigo
08/01/2011

Especifica a condição para o ponto de interrupção.

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

Sintaxe

'Declaração
ReadOnly Property Condition As String
    Get

string Condition { get; }

property String^ Condition {
    String^ get ();
}

abstract Condition : string

function get Condition () : String

Valor de propriedade

Tipo: System.String
Uma seqüência de caracteres que representa a condição de ponto de interrupção para a propriedade.

Comentários

Uma condição é uma propriedade opcional que determina se o seu programa interromper quando o ponto de interrupção é atingido. Essa condição é especificada na caixa de diálogo condição do ponto de interrupção.

A seqüência de caracteres retornada costuma ser uma expressão usada para determinar quando um ponto de interrupção é atingido.

Exemplos

O exemplo a seguir demonstra como usar o Condition propriedade.

Para testar essa propriedade:

Execute o add-in.
Execute o aplicativo de destino.

public static void Condition(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("Breakpoint Condition 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;
    //Stop at the breakpoint if TempC < TempF is true
    debugger.Breakpoints.Add("","Target001.cs", 15, 1, "tempC < tempF", 
    EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, 
    "C#","", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone);
    string strCondition = debugger.Breakpoints.Item(1).Condition;
    string strConditionType = debugger.Breakpoints.Item(1).ConditionType.ToString();
    owp.OutputString(strCondition + "\n" + strConditionType);
}

Shared Sub Condition(ByRef dte As EnvDTE.DTE)
    Dim strCondition As String
    Dim strType As String

    dte.Debugger.StepInto(True)
    dte.Debugger.Breakpoints.Add("", "Target001.cs", 15, 1, "tempC < tempF", _
                                 EnvDTE.dbgBreakpointConditionType.dbgBreakpointConditionTypeWhenTrue, _
                                 "C#", "", 0, "", 0, EnvDTE.dbgHitCountType.dbgHitCountTypeNone)
    strCondition = dte.Debugger.Breakpoints.Item(1).Condition.ToString()
    strType = dte.Debugger.Breakpoints.Item(1).ConditionType.ToString()
    MessageBox.Show("Condition Property Test: " + vbCrLf + _
                    strCondition + vbCrLf + strType)
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.