Debug in progetti a livello di applicazione

È possibile eseguire il debug dei progetti a livello di applicazione mediante gli stessi strumenti di Microsoft Visual Studio utilizzati per altri progetti Visual Studio. Le funzionalità di debugger di Visual Studio, come la capacità di inserire punti di interruzione e di visualizzare le variabili nella finestra Variabili locali, sono disponibili anche quando si esegue il debug dei progetti a livello di applicazione. Per ulteriori informazioni sugli strumenti di debug di Visual Studio, vedere Debugging in Visual Studio. Per ulteriori informazioni sui progetti a livello di applicazione, vedere Architettura dei componenti aggiuntivi a livello di applicazione.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Microsoft Office 2010 e Microsoft Office System 2007. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Per una dimostrazione video correlata, vedere Procedura: debug di un'applicazione VSTO (la pagina potrebbe essere in inglese).

Avvio e interruzione del debugger

Per avviare il debug di un progetto a livello di applicazione, è possibile procedere analogamente all'avvio del debug di altri progetti Visual Studio, ad esempio premendo F5. Quando si avvia il debug del progetto, viene avviato un nuovo processo per l'applicazione di Office di destinazione e viene caricato il componente aggiuntivo. Quando si arresta il debugger, questo interrompe improvvisamente il processo dell'applicazione o, se è stato impostato per la disconnessione, viene disconnesso. Per ulteriori informazioni, vedere Debugging Shortcut Keys, Brief Scheme.

Visualizzazione delle eccezioni

Se un componente aggiuntivo creato con gli strumenti di sviluppo di Office in Visual Studio genera un'eccezione, l'applicazione di Microsoft Office continua a funzionare senza visualizzarla. Se si desidera vedere quando vengono generate le eccezioni del componente aggiuntivo, impostare il debugger in modo da interrompersi per qualsiasi eccezione. Per ulteriori informazioni, vedere Procedura: gestire gli errori nei progetti Office.

È inoltre possibile racchiudere tra istruzioni Try...Catch il codice che può generare un'eccezione. Per ulteriori informazioni sull'utilizzo delle istruzioni Try...Catch, vedere Procedura: testare il codice con un blocco Try…Catch in Visual Basic e How to: Handle an Exception Using try/catch (C# Programming Guide).

Debug di componenti aggiuntivi disabilitati

Nelle applicazioni Microsoft Office è possibile disabilitare i componenti aggiuntivi che presentano un comportamento anomalo. Tale disattivazione ha lo scopo di impedire il caricamento di codice problematico a ogni avvio dell'applicazione. È tuttavia possibile che si verifichino comportamenti imprevisti anche durante il normale debug. Per informazioni sulla riattivazione dei componenti aggiuntivi, vedere Procedura: riabilitare un componente aggiuntivo disabilitato in precedenza.

Nelle applicazioni di Microsoft Office sono disponibili due tipi di disattivazione per i componenti aggiuntivi: a livello hardware e a livello software.

Disattivazione a livello hardware

La disabilitazione a livello hardware si verifica quando un componente aggiuntivo causa la chiusura imprevista dell'applicazione. Può anche verificarsi nel computer di sviluppo quando si arresta il debugger durante l'esecuzione del gestore eventi Startup del componente aggiuntivo. Quando un componente aggiuntivo viene disabilitato a livello hardware, viene visualizzato nell'elenco Elementi disabilitati nell'applicazione.

Se un componente aggiuntivo creato tramite gli strumenti di sviluppo di Office in Visual Studio viene disabilitato a livello hardware da un'applicazione di Office, viene disabilitato solo il componente aggiuntivo che ha provocato l'errore. Gli altri componenti aggiuntivi creati utilizzando gli strumenti di sviluppo di Office in Visual Studio per l'applicazione Office continueranno a essere caricati.

Disattivazione a livello software

La disattivazione a livello software si verifica quando un componente aggiuntivo genera un errore che non causa la chiusura imprevista dell'applicazione. Ad esempio, un'applicazione potrebbe disabilitare un componente aggiuntivo a livello software se viene generata un'eccezione non gestita durante l'esecuzione del gestore eventi Startup. Quando un componente aggiuntivo viene disabilitato a livello software, viene visualizzato nell'elenco Inactive Application Add-ins dell'applicazione e viene modificato il valore della voce del Registro di sistema LoadBehavior per indicare che il componente aggiuntivo è stato scaricato. Per ulteriori informazioni sulla chiave del Registro di sistema LoadBehavior, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.

Risoluzione degli errori di installazione mediante il Visualizzatore eventi

Runtime di Visual Studio Tools per Office scrive messaggi nel Visualizzatore eventi di Windows per tutte le eccezioni generate quando si installano o disinstallano soluzioni Office. Questi messaggi possono essere utilizzati per risolvere problemi di installazione e di distribuzione. Per ulteriori informazioni, vedere Registrazione degli eventi per le soluzioni Office.

Risoluzione degli errori di avvio mediante un file di log e messaggi di errore

In Runtime di Visual Studio Tools per Office è possibile scrivere tutti gli errori che si verificano all'avvio in un file di log o visualizzare ciascun errore in una finestra di messaggio. Per impostazione predefinita, queste opzioni sono disabilitate. Per attivarle, è possibile creare specifiche variabili di ambiente.

Per visualizzare ogni errore in una finestra di messaggio, creare una variabile di ambiente denominata VSTO_SUPPRESSDISPLAYALERTS e impostarla su 0 (zero). Per non visualizzare i messaggi, eliminare la variabile di ambiente o impostarla su 1 (uno).

Per scrivere gli errori in un file di log, creare una variabile di ambiente denominata VSTO_LOGALERTS e impostarla su 1 (uno). In Runtime di Visual Studio Tools per Office il file di log viene creato nella cartella che contiene il manifesto di distribuzione per il componente aggiuntivo oppure nella cartella %TEMP% locale. Il nome predefinito è nome componente aggiuntivo.vsto.log. Per interrompere la registrazione degli errori, eliminare la variabile di ambiente o impostarla su 0 (zero).

Vedere anche

Attività

Procedura: riabilitare un componente aggiuntivo disabilitato in precedenza

Procedura: gestire gli errori nei progetti Office

Altre risorse

Compilazione e debug delle soluzioni Office

Programmazione di componenti aggiuntivi a livello di applicazione

Cronologia delle modifiche