Debugger – rozhraní

Článek
08/11/2011

Debugger Použit objekt interrogate a manipulovat s nimi stavu ladicí program a program laděné.

Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
<GuidAttribute("338FB9A0-BAE5-11D2-8AD1-00C04F79E479")> _
Public Interface Debugger

[GuidAttribute("338FB9A0-BAE5-11D2-8AD1-00C04F79E479")]
public interface Debugger

[GuidAttribute(L"338FB9A0-BAE5-11D2-8AD1-00C04F79E479")]
public interface class Debugger

[<GuidAttribute("338FB9A0-BAE5-11D2-8AD1-00C04F79E479")>]
type Debugger =  interface end

public interface Debugger

Typ Debugger zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	AllBreakpointsLastHit	Získá kolekce zarážek vazby, které byly naposledy současně přístupů.
	BreakpointLastHit	Získá poslední zarážky přístupů.
	Breakpoints	Získá kolekce zarážek.
	CurrentMode	Načte aktuální režim ladění v rámci integrované vývojové prostředí (IDE).
	CurrentProcess	Nastaví nebo získává aktivní proces.
	CurrentProgram	Nastaví nebo získává aktivní aplikaci.
	CurrentStackFrame	Nastaví nebo získá aktuální snímek zásobníku.
	CurrentThread	Nastaví nebo získá aktuální podproces laděné.
	DebuggedProcesses	Získá seznam procesů právě laděn.
	DTE	Načtení objektu nejvyšší úrovně rozšiřitelnosti.
	HexDisplayMode	Získá nebo nastaví, zda jsou výrazy v šestnáctkovém nebo desítkovém formátu výstupu.
	HexInputMode	Získá nebo nastaví, zda výrazy jsou vyhodnocovány v šestnáctkovém nebo desítkovém formátu.
	Languages	Získá seznam jazyků, které podporuje ladicí program.
	LastBreakReason	Získá poslední důvod programu bylo přerušeno.Pokud program je spuštěn vrátí DBG_REASON_NONE.
	LocalProcesses	Získá seznam procesů aktuálně spuštěné v počítači.
	Parent	Bezprostřední nadřízený objekt dostane Debugger objektu.

Na začátek

Metody

	Název	Popis
	Break	Způsobí, že daný proces přerušit jeho tak, že lze analyzovat aktuální stav.
	DetachAll	Odpojí se od všech připojených programů.
	ExecuteStatement	Provede zadaný příkaz.Pokud TreatAsExpression je příznak true, je řetězec interpretován jako výraz a výstup je odeslán do příkazového okna.
	GetExpression	Vyhodnotí výraz na základě aktuálního snímku zásobníku.Pokud výraz lze analyzovat, ale nebudou vyhodnoceny, objekt je vrácena, ale neobsahuje platnou hodnotu.
	Go	Spustí program spuštění aktuálního příkazu.
	RunToCursor	Spustí program na aktuální pozici kurzoru zdrojového souboru.
	SetNextStatement	Nastaví další instrukce mají být provedeny podle umístění kurzoru v aktuální zdrojový soubor.
	StepInto	Kroky do další funkce volání, pokud možno.
	StepOut	Kroky z aktuální funkce.
	StepOver	Kroky přes další volání funkce.
	Stop	Zarážky ladění, ukončení nebo odpojení ze všech připojených procesů.
	TerminateAll	Ukončí všechny procesy.

Na začátek

Poznámky

Ladicí program je k dispozici DTE objektu formou jeho Debugger Vlastnosti, jak je znázorněno v následujícím příkladu. Jeden objekt debugger je k dispozici pro každou instanci vývojové prostředí.

Příklady

Následující příklad ukazuje způsob použití objektu ladicí program.

Imports EnvDTE
Imports System.Diagnostics

Public Module Module1
    ' This function returns true if the debugger is actively debugging.

    Function IsDebugging() As Boolean
        Dim debugger As EnvDTE.Debugger
        debugger = DTE.Debugger

        If (debugger Is Nothing) Then
            MsgBox("Debugger doesn't exist! Fatal error.")
            IsDebugging = false
        Else
            IsDebugging = (debugger.CurrentMode <> dbgDebugMode.dbgDesignMode)
        End If
    End Function
End Module

// The following small C++ program can be run from the command line.
// It detects whether an instance of Visual Studio is currently 
// running,and if so, prints a message stating whether its debugger
// is actively debugging.

#include <stdio.h>
#import "dte.olb" raw_interfaces_only named_guids

using namespace EnvDTE;

int main(void)
{
    int nRet = 0;

    CoInitialize(NULL);

    IUnknownPtr pUnk;
    GetActiveObject(CLSID_DTE, NULL, &pUnk);

    if (pUnk == NULL) {
        printf ("No instance of Visual Studio is running.\n");
    }
    else {
        _DTEPtr pDTE = pUnk;
        if (pDTE) {
            DebuggerPtr pDebugger;
            if (SUCCEEDED(pDTE->get_Debugger(&pDebugger)) && pDebugger != NULL){
                dbgDebugMode mode;
                if (SUCCEEDED(pDebugger->get_CurrentMode(&mode))) {
                    if (mode != dbgDesignMode) {
                        printf("Debugger is active.\n");
                        nRet = 1;
                    }
                    else {
                        printf("Debugger is not active.\n");
                    }
                }
            }
        }
    }

    CoUninitialize();

    return nRet;
}