Debug di progetti Office

È possibile eseguire il debug dei progetti di Office utilizzando gli stessi strumenti di Microsoft Visual Studio utilizzate per altri progetti Visual Studio.Le funzionalità del debugger diVisual Studio, ad esempio la possibilità di inserire punti di interruzione e di visualizzare le variabili nella finestra Variabili locali, sono disponibili anche quando si esegue il debug di progetti di Office.Per ulteriori informazioni sugli strumenti di debug di Visual Studio, vedere Debug in Visual Studio.

Suggerimento
Per semplificare il debug, chiudere eventuali istanze aperte dell'applicazione di Office prima che la compilare ed eseguire il debug.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Office 2013 e Office 2010. 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 di Office all'avvio del debug di altri progetti Visual Studio ; ad esempio, è possibile premere il tasto F5.Quando si avvia il debug di un progetto di componente aggiuntivo a livello di applicazione, un nuovo processo per l'applicazione di Office di destinazione viene avviato e il componente aggiuntivo viene caricato.Quando si avvia il debug di un progetto a livello di documento, il documento o la cartella di lavoro viene aperto in Word o in un processo di Excel nuovo.

Quando si arresta il debugger, questo interrompe improvvisamente il processo dell'applicazione o, se è stato impostato per la disconnessione, viene disconnesso.Tutti gli altri documenti aperti nel processo dell'applicazione di Office non sono chiusi senza avviso e alcune modifiche non salvate andranno persi.Possono essere inclusi tutti i documenti o le cartelle di lavoro che vengono aperti mentre il debugger è in esecuzione.

In genere, è preferibile disconnettersi dal processo prima di arrestare il debugger, per interrompere l'applicazione di Office nel modo normale.È anche possibile rimuovere dal processo innanzitutto se si desidera utilizzare un documento aperto o un foglio di lavoro dopo l'arresto del debugger.Per ulteriori informazioni sulla disconnessione dal processo, vedere Procedura: disconnettere tutti i processi.

Se si esegue il debug di una personalizzazione a livello di documento per Word, arrestandosi ripetutamente il debugger e Word causare chiusura improvvisa possono comportare un modello Normal che è danneggiato.In questo caso è possibile eliminare il modello Normal danneggiato, che verrà ricreato automaticamente alla successiva apertura di Word.Tuttavia, qualsiasi macro memorizzata nel modello Normal.dot non verrà ricreata.

Comportamento di F10 e F11

All'avvio del debug di un progetto Office, il comportamento di F10 e F11 varia rispetto a quando si esegue il debug di progetti Visual Basic o C#.In Visual Basic o C#, il debugger si arresta sulla funzione principale, mentre in Office, Visual Studio non dispone del controllo sulla funzione principale dell'applicazione di Office.Durante il debug, pertanto, F10 e F11 hanno le stesse funzioni come nei progetti di Visual Basic e C#.

Visualizzazione delle eccezioni

A causa della modalità di interazione del codice gestito con il codice non gestito, in Visual Studio non vengono visualizzati gli errori generati dalle applicazioni di Microsoft Office.Ad esempio, se un componente aggiuntivo creato tramite gli strumenti di sviluppo di Office in Visual Studio genera un'eccezione, l'applicazione di Microsoft Office continua senza visualizzare un errore.Per visualizzare questi errori, impostare il debugger affinché venga interrotta l'esecuzione in corrispondenza delle eccezioni di Common Language Runtime.Per ulteriori informazioni, vedere Procedura: interrompere l'esecuzione in caso di eccezione.

Se si imposta il debugger in modo da interrompere le eccezioni di Common Language Runtime, tutte le eccezioni ora si interromperà nel debugger, incluse quelle gestite e alcune eccezioni first-chance di runtime stesso, che potrebbero non essere rilevanti per il progetto.Gli errori che fanno riferimento a msosec non trovato vengono visualizzati in ogni progetto, ma è possibile ignorarli.Queste eccezioni msosec non avranno effetto sulla soluzione.

È inoltre possibile racchiudere tra istruzioni Try...Catch i metodi per intercettare le eccezioni.

Per impostazione predefinita, Visual Studio non visualizza inoltre errori di debug JIT (Just-In-Time) per i progetti Office. Tuttavia, è possibile attivare questa funzionalità per visualizzare gli errori generati.Per ulteriori informazioni, vedere Debug JIT.

Argomenti della riga di comando

Se l'opzione Azione di avvio della pagina delle proprietà Debug è impostata su Avvia progetto, nel debug del progetto non vengono utilizzati gli argomenti della riga di comando, anche se questi sono stati specificati come opzioni di avvio.Se si desidera utilizzare gli argomenti della riga di comando quando si avvia il debug, è necessario selezionare una Azione di avvio diversa da Avvia progetto.

Controllo del codice sorgente

Le proprietà di debug non sono condivise tra più utenti sotto il controllo del codice sorgente.I progetti di Visual Basic e C# le proprietà di debug vengono memorizzate in un file specifico dell'utente (ProjectName.vbproj.user o .csproj.user) ProjectNametale file non è incluso nel controllo del codice sorgente.Se più di un utente esegue il debug, è necessario che ciascuno immetta manualmente le proprietà di debug.

Il debug dei dataset memorizzati nella cache in un progetto a Livello di documento

Ogni volta che si compila un progetto, il dataset viene svuotato e ricreato.Per eseguire il debug di un DataSet memorizzato nella cache, aprire il documento all'esterno di Visual Studio, quindi collegare il debugger.

Esecuzione del debug dei progetti Documento di Word basati sul formato di documento di Word 97-2003 (*.doc)

Per eseguire il debug di un progetto Documento di Word basato sul formato di documento di Word 97-2003 (*.doc) è necessario aggiungere la cartella del progetto all'elenco delle cartelle attendibili.Per ulteriori informazioni, vedere. Concessione dell'attendibilità ai documenti.

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.

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).Runtime di Visual Studio Tools per Office crea il file di log nella cartella che contiene il manifesto di distribuzione per il componente aggiuntivo, o nella cartella che contiene il documento o la cartella di lavoro associata alla personalizzazione.Se tale autenticazione non riesce, Runtime di Visual Studio Tools per Office crea il file di log nella cartella locale %TEMP%.Per i componenti aggiuntivi a livello di applicazione, il nome predefinito è nome del componente aggiuntivo.vsto.log.Per i progetti a livello di documento, il nome del file di log è nome del documento.estensione.log, ad esempio ExcelWorkbook1.xlsx.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

Altre risorse

Compilazione di soluzioni Office

Programmazione di componenti aggiuntivi a livello di applicazione