Interfaccia Debugger3

Articolo
05/16/2015

L'oggetto Debugger3 viene utilizzato per interrogare e modificare lo stato del debugger e del programma sottoposto a debug. Debugger3 sostituisce le interfacce Debugger2 e Debugger.

Spazio dei nomi: EnvDTE90
Assembly: EnvDTE90 (in EnvDTE90.dll)

Sintassi

'Dichiarazione
<GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")> _
Public Interface Debugger3 _
    Inherits Debugger2

[GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")]
public interface Debugger3 : Debugger2

[GuidAttribute(L"87DFC8DA-67B4-4954-BB89-6A277A50BAFC")]
public interface class Debugger3 : Debugger2

[<GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")>]
type Debugger3 =  
    interface 
        interface Debugger2 
    end

public interface Debugger3 extends Debugger2

Il tipo Debugger3 espone i seguenti membri.

Proprietà

	Nome	Descrizione
	AllBreakpointsLastHit	Ottiene una raccolta di punti di interruzione associati raggiunti per ultimi contemporaneamente.
	BreakpointLastHit	Ottiene l'ultimo punto di interruzione raggiunto.
	Breakpoints	Ottiene una raccolta di punti di interruzione.
	CurrentMode	Ottiene la modalità corrente del debugger nel contesto dell'IDE.
	CurrentProcess	Ottiene o imposta il processo attivo.
	CurrentProgram	Imposta o restituisce il programma attivo.
	CurrentStackFrame	Ottiene o imposta lo stack frame corrente.
	CurrentThread	Ottiene o imposta il thread corrente di cui è in corso il debug.
	DebuggedProcesses	Ottiene l'elenco dei processi di cui è in corso il debug.
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	ExceptionGroups	Ottiene le impostazioni di eccezione per il debugger.Per ogni eccezione le impostazioni stabiliscono se il debugger consente al codice di gestire l'eccezione prima che il debugger interrompa l'esecuzione.
	ForceContinue	Ottiene o imposta un valore che stabilisce se il debugger si interrompe o continua quando un punto di analisi o un punto di interruzione termina l'esecuzione di una macro.Il comportamento predefinito viene impostato dall'utente nella finestra di dialogo al momento della creazione del punto di analisi o del punto di interruzione.Questa proprietà consente di modificare il comportamento predefinito.
	HexDisplayMode	Ottiene o imposta un valore che indica se le espressioni sono generate in formato decimale o esadecimale.
	HexInputMode	Ottiene o imposta un valore che indica se le espressioni sono valutate in formato decimale o esadecimale.
	Languages	Ottiene un elenco di linguaggi supportati dal debugger.
	LastBreakReason	Ottiene l'ultima causa dell'interruzione di un programma.Se il programma è in esecuzione, viene restituito DBG_REASON_NONE.
	LocalProcesses	Ottiene l'elenco dei processi attualmente in esecuzione nel computer.
	OnlyLoadSymbolsManually	Ottiene un valore che determina se i simboli sono caricati manualmente o automaticamente.L'utente di Visual Studio può definire questa impostazione nella finestra di dialogo Opzioni.Per ulteriori informazioni su come impostare tale valore in Visual Studio, vedere [OBSOLETO] Procedura: specificare percorsi di simboli e comportamento di caricamento.
	Parent	Ottiene l'oggetto padre diretto dell'oggetto Debugger3 (DTE2).
	SymbolCachePath	Ottiene una stringa contenente il percorso alla cache dei simboli utilizzata in Visual Studio quando si scaricano simboli da un server di simboli.Per specificare il percorso della cache dei simboli è possibile utilizzare la finestra di dialogo Opzioni.Per ulteriori informazioni, vedere [OBSOLETO] Procedura: utilizzare un server di simboli.
	SymbolPath	Ottiene una stringa contenente percorsi di file di simboli PDB utilizzati in Visual Studio per l'esecuzione del debug.L'utente di Visual Studio può specificare i percorsi dei simboli nella finestra di dialogo Opzioni.Per ulteriori informazioni, vedere [OBSOLETO] Procedura: specificare percorsi di simboli e comportamento di caricamento.
	SymbolPathState	Ottiene una stringa che rappresenta lo stato di tutti i percorsi dei file di simboli PDB utilizzati in Visual Studio per l'esecuzione del debug.
	Transports	Ottiene una raccolta di trasporti di debug supportati.

In alto

Metodi

	Nome	Descrizione
	Break	Provoca la sospensione dell'esecuzione del processo specificato in modo da consentire l'analisi del suo stato corrente.
	DetachAll	Disconnette da tutti i programmi collegati.
	ExecuteStatement	Esegue l'istruzione specificata.Se il flag TreatAsExpression è true, la stringa viene interpretata come un'espressione e l'output viene inviato a Finestra di comando.
	GetExpression	Valuta un'espressione basata sullo stack frame corrente.Se l'espressione può essere analizzata, ma non valutata, viene restituito un oggetto, ma il valore in esso contenuto non sarà valido.
	GetExpression2	Valuta un'espressione basata sullo stack frame corrente.Se l'espressione può essere analizzata, ma non valutata, viene restituito un oggetto, ma il valore in esso contenuto non sarà valido.Questa funzione membro è simile a GetExpression ma con un parametro booleano aggiuntivo che può essere impostato su true per indicare che l'espressione deve essere valutata come un'istruzione.
	GetProcesses
	Go	Avvia l'esecuzione del programma dall'istruzione corrente.
	RunToCursor	Esegue il programma nella posizione corrente del cursore del file di origine.
	SetNextStatement	Imposta la successiva istruzione da eseguire in base alla posizione corrente del cursore nel file di origine.
	SetSymbolSettings	Definisce varie impostazioni per i simboli PDB utilizzati in Visual Studio per il debug e impone il nuovo caricamento di tutti i simboli.
	StepInto	Esegue la chiamata di funzione successiva, se possibile.
	StepOut	Esce dalla funzione corrente.
	StepOver	Esegue la chiamata di funzione successiva.
	Stop	Interrompe il debug e termina o disconnette tutti i processi collegati.
	TerminateAll	Termina tutti i processi di debug in esecuzione.
	WriteMinidump

In alto

Note

Il debugger è accessibile dall'oggetto DTE2 tramite la proprietà Debugger, come illustrato nell'esempio seguente. Un oggetto debugger è disponibile per ogni istanza dell'ambiente di sviluppo interattivo (IDE).

Esempi

Imports System
Imports EnvDTE
Imports EnvDTE90
Imports EnvDTE90
Imports System.Diagnostics

Public Module Module1
    'This function returns true if the debugger is actively debugging.
    Function IsDebugging() As Boolean
        Dim debugger As EnvDTE90.Debugger3 
        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 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 "dte90.olb" raw_interfaces_only named_guids
using namespace EnvDTE90;
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(&pDebugger3)) && 
            pDebugger3
            != NULL){
                dbgDebugMode mode;
                if (SUCCEEDED(pDebugger3->get_CurrentMode(&mode))) {
                    if (mode != dbgDesignMode) {
                        printf("Debugger is active.\n");
                        nRet = 1;
                    }
                    else {
                        printf("Debugger is not active.\n");
                    }
                }
            }
        }
    }
    CoUninitialize();
    return nRet;
}

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE90

Condividi tramite