Debug nei progetti a livello di documento

È possibile eseguire il debug di progetti a livello di documento per Microsoft Word e Microsoft Excel utilizzando gli stessi strumenti di Visual Studio impiegati per altri progetti. Quando si esegue il progetto in modalità debug, viene avviato Word o Excel e il debugger si connette a qualsiasi elemento in esecuzione nello stesso processo in cui sono in esecuzione Word o Excel. Per ulteriori informazioni sugli strumenti di debug di Visual Studio, vedere Debugging in Visual Studio.

Suggerimento
Per evitare conflitti, prima di compilare ed eseguire il debug, chiudere tutte le istanze aperte di Word o Excel.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007, Excel 2010, Word 2007 e Word 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).

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#. Per ulteriori informazioni, vedere Debugging Shortcut Keys, Brief Scheme.

Arresto del debugger

Quando si avvia il debug di un documento o di una cartella di lavoro, il documento o la cartella di lavoro si apre in un nuovo processo di Word o Excel. Quando si arresta il debugger, questo interrompe improvvisamente il processo di Word o Excel o, se viene impostato per disconnettersi, viene disconnesso. Vengono chiusi senza avviso anche tutti gli altri documenti o cartelle di lavoro aperti in un processo di Word o di Excel, che viene quindi terminato con conseguente perdita di tutte le modifiche non salvate. 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 poter chiudere Word ed Excel in modo normale. È anche possibile disconnettersi prima dal processo se si lavora ancora in un documento o in un foglio di lavoro aperto dopo l'arresto del debugger. Per ulteriori informazioni sulla disconnessione dal processo, vedere How to: Detach All Processes.

Durante le sessioni di debug intensivo, l'arresto ripetuto del debugger e la chiusura improvvisa di Word possono portare al danneggiamento del modello Normal. 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.

Blocco da parte di Word del modello Normal mentre è aperto in Visual Studio

Quando si apre Word in Visual Studio, il modello Normal predefinito viene bloccato. Quando la soluzione viene eseguita per il debug, viene aperta una copia di Word in un altro processo. Se la copia aperta di Word viene personalizzata a livello di applicazione, tali modifiche non potranno essere salvate in quanto il modello Normal viene bloccato dal processo aperto all'interno di Visual Studio.

In fase di esecuzione, Word apre istanze separate di documenti in un singolo processo. È quindi meno probabile che un unico documento aperto blocchi il modello Normal e impedisca le modifiche a livello di applicazione.

Per ulteriori informazioni, vedere l'articolo della Knowledge Base "PRB: Prompt to Save Normal.dot When Using Word as an Automation Server" all'indirizzo https://support.microsoft.com/kb/285885/it (informazioni in lingua inglese).

Debug di dataset memorizzati nella cache

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 su questa procedura, vedere Concessione dell'attendibilità ai documenti.

Controllo del codice sorgente

Le proprietà di debug non sono condivise tra più utenti sotto il controllo del codice sorgente. Nei progetti di Visual Basic e C# le proprietà di debug vengono memorizzate in un file specifico (<NomeProgetto>.vbproj.user o <NomeProgetto>.csproj.user) e questo 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.

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.

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). Runtime di Visual Studio Tools per Office crea il file di log nella cartella contenente il documento o la cartella di lavoro associata alla personalizzazione o nella cartella locale %TEMP%. Il nome del file di log è nome 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: gestire gli errori nei progetti Office

Concetti

Cenni preliminari sul processo di compilazione delle soluzioni Office

Altre risorse

Debugging in Visual Studio

Distribuzione di soluzioni Office

Progettazione e creazione di soluzioni Office

Compilazione e debug delle soluzioni Office

Cronologia delle modifiche

Data	Cronologia	Motivo
Settembre 2010	Aggiunta una sezione sulla risoluzione degli errori di installazione mediante il Visualizzatore eventi.	Miglioramento delle informazioni.
Maggio 2010	Corretti alcuni dettagli sugli errori di registrazione.	Correzione di bug nel contenuto.