Debug nei progetti a livello di documento
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 Funzionalità disponibili in base ai tipi di progetto e applicazione. |
È 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 Debug in Visual Studio.
.gif "Suggerimento:") Suggerimento: |
|---|
Per evitare conflitti, prima di compilare ed eseguire il debug, chiudere tutte le istanze aperte di Word o Excel. |
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 Tasti di scelta rapida per il debug, schema Brief.
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 Excel, che viene quindi terminato, e tutte le modifiche non salvate vanno perdute. Possono essere inclusi tutti i documenti o le cartelle di lavoro che vengono aperti mentre il debugger è in esecuzione. È preferibile disconnettersi dal processo prima di arrestare il debugger, per poter chiudere Word ed Excel in modo normale.
Durante le sessioni di debug intensivo, l'arresto ripetuto del debugger e la chiusura improvvisa di Word possono danneggiare il file Normal.dot. In questo caso è possibile eliminare il modello Normal.dot danneggiato che verrà ricreato automaticamente alla successiva apertura di Word. Tutte le macro memorizzate nel modello Normal.dot non verranno tuttavia ricreate.
Se si desidera arrestare il debugger e continuare a utilizzare un documento o un foglio di lavoro aperto, disconnettere prima il debugger dal processo, quindi arrestarlo. Per ulteriori informazioni, vedere Procedura: disconnettere tutti i processi.
Il Normal.dot viene bloccato quando Word è aperto in Visual Studio
Il modello predefinito Normal.dot viene bloccato quando Word è aperto in Visual Studio. 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, ad esempio modificando le barre degli strumenti o i menu, non sarà possibile salvare tali modifiche in quanto il Normal.dot è bloccato dal processo aperto all'interno di Visual Studio.
In fase di esecuzione, Word apre istanze separate di documenti in un singolo processo, quindi non sarà così probabile che un documento aperto possa bloccare il Normal.dot e impedisca 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/default.aspx?scid=kb;it-it;285885 (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 di Word 2007 basati sul formato di documento di Word 97-2003 (*.doc)
Per eseguire il debug di un progetto di documento di Word 2007 basato sul formato di documento di Word 97-2003 (*.doc) è necessario aggiungere la cartella del progetto all'elenco di cartelle attendibili. Per ulteriori informazioni su questa procedura, vedere Concessione dell'attendibilità ai documenti (2007 System).
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 dei problemi con un file di log e messaggi di errore
Visual Studio Tools per Office è in grado di scrivere tutti gli errori in un file di log. Per impostazione predefinita, questa opzione è disattivata per i progetti Word ed Excel. È possibile attivare questa opzione aggiungendo la variabile di ambiente VSTO_LOGALERTS e impostando il valore su 1 (uno). Visual Studio Tools per Office creerà il file di log nella cartella di output in cui viene creato il documento della soluzione o, se tale operazione non riesce, nella cartella %TEMP%. Il nome predefinito del file di log è <Documentname>.doc.log per Word e <Documentname>.xls.log per Excel. Per interrompere la registrazione degli errori, impostare la variabile su 0 (zero).
Per impostazione predefinita, in Visual Studio Tools per Office ogni errore viene visualizzato in una finestra di messaggio per Word ed Excel. Per interrompere la visualizzazione dei messaggi di errore, aggiungere la variabile di ambiente VSTO_SUPPRESSDISPLAYALERTS e impostare il valore su 1 (uno). Per visualizzare i messaggi di errore, impostare la variabile su 0 (zero).
Per informazioni sull'impostazione delle variabili di ambiente in Microsoft Windows XP, vedere "How To Manage Environment Variables in Windows XP" all'indirizzo https://support.microsoft.com/default.aspx?scid=kb;it-it;310519.
Vedere anche
Attività
Procedura: gestire gli errori nei progetti Office
Concetti
Distribuzione di soluzioni Office (System 2003)
Distribuzione di soluzioni Office (2007 System)
Creazione di soluzioni Office in Visual Studio
Cenni preliminari sul processo di generazione delle soluzioni Office