Debug in progetti a livello di applicazione
Aggiornamento: novembre 2007
Si applica a |
|---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto
Versione Microsoft Office
Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione. |
È possibile eseguire il debug di progetti a livello di applicazione utilizzando gli stessi strumenti di Microsoft Visual Studio utilizzati per altri progetti Visual Studio. Le funzionalità del debugger di Visual Studio, ad esempio la possibilità di inserire punti di interruzione e variabili di visualizzazione nella finestra Variabili locali, sono disponibili anche quando si esegue il debug di progetti a livello di applicazione. Per ulteriori informazioni sugli strumenti di debug di Visual Studio, vedere Debug in Visual Studio. Per ulteriori informazioni sui progetti a livello di applicazione, vedere Architettura dei componenti aggiuntivi a livello di applicazione.
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 Tasti di scelta rapida per il debug, schema Brief.
Visualizzazione delle eccezioni
Se un componente aggiuntivo creato con Visual Studio Tools per Office 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: verificare il codice con un blocco Try…Catch in Visual Basic e Procedura: gestire un'eccezione utilizzando Try/Catch (Guida per programmatori C#).
Debug di componenti aggiuntivi disattivati
Nelle applicazioni di Microsoft Office i componenti aggiuntivi che si comportano in modo imprevisto durante il caricamento possono essere disattivati automaticamente. 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: riattivare un componente aggiuntivo disattivato 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 disattivazione a livello hardware si verifica quando il codice eseguito durante il caricamento del componente aggiuntivo provoca la chiusura imprevista dell'applicazione oppure quando si arresta il debugger durante l'esecuzione del costruttore o del gestore eventi Startup.
Se un componente aggiuntivo creato tramite Visual Studio Tools per Office viene disattivato a livello hardware da un'applicazione di Microsoft Office 2003, vengono disattivati sia il componente aggiuntivo sia AddinLoader.dll. AddinLoader.dll viene utilizzato per caricare i componenti aggiuntivi creati utilizzando Visual Studio Tools per Office. Di conseguenza, tutti i componenti aggiuntivi creati tramite Visual Studio Tools per Office per l'applicazione di Microsoft Office non potranno essere caricati per l'utente corrente. Per ulteriori informazioni su AddinLoader.dll, vedere Architettura dei componenti aggiuntivi a livello di applicazione.
Se un componente aggiuntivo creato tramite Visual Studio Tools per Office viene disattivato a livello hardware da un'applicazione di Microsoft Office System 2007, viene disattivato solo il componente aggiuntivo che ha provocato l'errore. Di conseguenza, gli altri componenti aggiuntivi creati utilizzando Visual Studio Tools per Office per l'applicazione di Office 2007 continueranno a essere caricati.
Disattivazione a livello software
La disattivazione a livello software si verifica quando un componente aggiuntivo genera un'eccezione non gestita nel costruttore o nel gestore eventi Startup e l'applicazione di Microsoft Office non viene chiusa in modo imprevisto. Tramite l'applicazione potrebbe essere disattivato solo il caricamento del componente aggiuntivo per l'utente corrente. Quando un componente aggiuntivo viene disattivato a livello software da un'applicazione, il valore della voce del Registro di sistema LoadBehavior relativa a tale componente viene impostato su 2. La voce LoadBehavior si trova nella seguente chiave del Registro di sistema: HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<nome applicazione>\Addins\<nome componente aggiuntivo>. Per ulteriori informazioni su questa chiave del Registro di sistema, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.
Risoluzione dei problemi relativi ai componenti aggiuntivi con un file di log e messaggi di errore
Il runtime di Visual Studio Tools per Office può 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 disattivate. 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). Il runtime di Visual Studio Tools per Office crea il file di log nella cartella che contiene il manifesto dell'applicazione. Il nome predefinito è <NomeManifesto>.manifest.log. Per interrompere la registrazione degli errori, eliminare la variabile di ambiente o impostarla su 0 (zero).
Vedere anche
Attività
Procedura: riattivare un componente aggiuntivo disattivato in precedenza
Procedura: gestire gli errori nei progetti Office
Concetti
Programmazione di componenti aggiuntivi a livello di applicazione