Procedura dettagliata: debug di un progetto di componente aggiuntivo
Nella presente procedura dettagliata viene illustrato come creare un semplice progetto di componente aggiuntivo Visual Studio e come utilizzare i punti di interruzione per eseguire il debug del progetto. Per ulteriori informazioni, vedere Punti di interruzione e punti di analisi.
I componenti aggiuntivi sono applicazioni compilate che utilizzano il modello a oggetti di automazione Visual Studio per gestire e automatizzare l'ambiente di sviluppo integrato (IDE). Per ulteriori informazioni, vedere Creazione di componenti aggiuntivi e di procedure guidate.
Nota
È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. Queste procedure sono state sviluppate con le Impostazioni generali per lo sviluppo attive. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Gestione delle impostazioni.
Per creare un semplice progetto di componente aggiuntivo Visual Studio
Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Verrà visualizzata la New Project Dialog Box.
Nel riquadro Tipi progetto, espandere Altri tipi di progetto, quindi scegliere Estensibilità.
Nel riquadro Modelli selezionare Componente aggiuntivo Visual Studio.
Nel campo Nome immettere Componente aggiuntivo semplice come nome del progetto di componente aggiuntivo. Scegliere OK.
Verrà avviata la Welcome to the Add-In Wizard, Visual Studio Add-In Wizard.
Nella pagina Creazione guidata componente aggiuntivo scegliere Avanti.
Nella pagina Selezionare un linguaggio di programmazione scegliere Crea componente aggiuntivo utilizzando Visual C#, quindi scegliere Avanti.
Nella pagina Selezionare un'applicazione host non cambiare le opzioni predefinite e scegliere Avanti.
Nella pagina Specificare un nome e una descrizione immettere Componente aggiuntivo semplice come nome del componente aggiuntivo e quindi Utilizzato per illustrare come eseguire il debug di un'aggiunta semplice come descrizione. Scegliere Next.
Nella pagina Scegliere le opzioni del componente aggiuntivo selezionare l'opzione Sì, crea una voce di menu 'Strumenti'. Non cambiare i valori predefiniti. Fare clic su Avanti.
Nella pagina Scelta della finestra 'Informazioni su' selezionare l'opzione Sì, rendi disponibile la finestra 'Informazioni su' per il componente aggiuntivo, quindi scegliere Avanti.
Nella pagina Riepilogo scegliere Fine.
La Creazione guidata componente aggiuntivo genera il nuovo progetto di componente aggiuntivo e apre l'ambiente di sviluppo integrato (IDE) attivando il file Connect.cs., ovvero la classe principale che contiene il codice per il componente aggiuntivo.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo Riferimenti e scegliere Aggiungi riferimento per aggiungere un riferimento all'assembly.
Questa operazione consente di utilizzare i tipi inclusi nello spazio dei nomi System.Windows.Forms.
Verrà visualizzata la Add Reference Dialog Box.
Nella scheda .NET fare doppio clic sul componente System.Windows.Forms.dll.
Nel nodo Riferimenti di Esplora soluzioni verrà visualizzato un riferimento allo spazio dei nomi System.Windows.Forms.
Questo spazio dei nomi contiene il codice necessario per la visualizzazione di una finestra di messaggio utilizzata nell'esempio di codice seguente.
In Connect.cs aggiungere l'istruzione riportata di seguito accanto alla parte superiore dell'ambito SimpleAddIn per semplificare l'utilizzo di un oggetto MessageBox:
using System.Windows.Forms;Per aggiungere un oggetto MessageBox al componente aggiuntivo, aggiungereMessageBox.Show("Debugging a Simple Add-in"); al metodo Exec in Connect.cs:
public void Exec(string commandName, vsCommandExecOption executeOption, ref object varIn, ref object varOut, ref bool handled) { handled = false; if(executeOption == vsCommandExecOption.vsCommandExecOptionDoDefault) { if(commandName == "MyAddin1.Connect.MyAddin1") { handled = true; MessageBox.Show("Debugging a Simple Add-in"); return; } } }Fare clic sul pulsante Salva tutto per salvare il lavoro.
Per eseguire il debug del progetto di componente aggiuntivo Visual Studio
In Connect.cs fare clic sul margine sinistro in corrispondenza dell'istruzione:
MessageBox.Show("Debugging a Simple Add-in")Verrà visualizzato un punto di colore rosso (punto di interruzione) e il testo su questa riga verrà evidenziato in rosso.
Scegliere Avvia debug dal menu Debug.
La sessione corrente di Visual Studio (la sessione del debugger) non risulterà più attivata e il programma in fase di debug verrà aperto in un'altra istanza di Visual Studio.
Nell'ambiente di sviluppo integrato di Visual Studio in corso di debug fare clic sul menu Strumenti.
Componente aggiuntivo semplice si trova in cima alle voci di menu.
Selezionare il comando Componente aggiuntivo semplice per eseguire il componente aggiuntivo.
Verrà visualizzata la riga, evidenziata in giallo, in cui è stato impostato il punto di interruzione nella sessione del debugger di Visual Studio.
Scegliere Esegui istruzione dal menu Debug nella sessione del debugger.
L'attivazione passerà al programma di cui è stato eseguito il debug. Verrà visualizzata la finestra del messaggio in cui è indicato che il componente aggiuntivo è stato eseguito.
Scegliere OK per chiudere la finestra di messaggio.
Nella sessione del debugger selezionare Continua dal menu Debug.
Verrà nuovamente attivata la sessione di Visual Studio in fase di debug.
Uscire dalla sessione di Visual Studio in fase di debug.
In Connect.cs fare clic sul punto di interruzione impostato accanto all'istruzione MessageBox per rimuoverlo dal codice sorgente.
Come si può notare, quando si esegue il debug di un componente aggiuntivo, viene aperta un'altra istanza dell'IDE di Visual Studio che ospita il componente aggiuntivo in esecuzione. La prima istanza mostra il codice e consente di eseguire operazioni di debug, ad esempio di impostare le variabili di controllo, i punti di interruzione e così via. Al termine del processo di debug, verrà chiusa la seconda istanza IDE per ritornare al codice del componente aggiuntivo nella prima istanza.