Condividi tramite

Procedura dettagliata: Creare il primo componente aggiuntivo VSTO per Excel

  • Articolo

Questa procedura dettagliata introduttiva descrive come creare un componente aggiuntivo a livello di applicazione per Microsoft Office Excel. Le funzionalità create dall'utente in questo tipo di soluzione sono disponibili per l'applicazione stessa, indipendentemente da quali cartelle di lavoro siano aperte.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per Excel. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Nota

Si è interessati allo sviluppo di soluzioni che estendono l'esperienza di Office tra più piattaforme? Vedere il nuovo modello di componenti aggiuntivi per Office. I componenti aggiuntivi di Office hanno un footprint ridotto rispetto ai componenti aggiuntivi e alle soluzioni VSTO ed è possibile compilarli usando quasi qualsiasi tecnologia di programmazione Web, ad esempio HTML5, JavaScript, CSS3 e XML.

In questa procedura dettagliata sono illustrati i task seguenti:

  • Creazione di un progetto di componente aggiuntivo VSTO per Excel.

  • Scrittura di codice che usa il modello a oggetti di Excel per aggiungere testo a una cartella di lavoro, quando viene salvata.

  • Creazione ed esecuzione del progetto a scopo di test.

  • Pulizia del progetto completato, per fare in modo che il componente aggiuntivo VSTO non venga più eseguito automaticamente nel computer di sviluppo.

    Nota

    I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei componenti seguenti:

Creare il progetto

Per creare un nuovo progetto di componente aggiuntivo VSTO per Excel in Visual Studio

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu Filee quindi fare clic su Progetto.

  3. Nel riquadro dei modelli, espandere Visual C# o Visual Basic, quindi espandere Office/SharePoint.

  4. Nel nodo Office/SharePoint espanso, selezionare il nodo Componenti aggiuntivi di Office .

  5. Nell'elenco relativo ai modelli di progetto, selezionare Componente aggiuntivo per Excel 2010 o Componente aggiuntivo per Excel 2013.

  6. Nella casella Nome , digitare FirstExcelAddIn.

  7. Fare clic su OK.

    Visual Studio crea il progetto FirstExcelAddIn e apre il file di codice ThisAddIn nell'editor.

Scrivere codice per aggiungere testo alla cartella di lavoro salvata

Aggiungere quindi codice al file di codice ThisAddIn. Il nuovo codice usa il modello a oggetti di Excel al fine di inserire testo boilerplate nella prima riga del foglio di lavoro attivo. Il foglio di lavoro attivo è quello aperto quando l'utente salva la cartella di lavoro. Per impostazione predefinita, il file di codice ThisAddIn contiene il seguente codice generato:

  • Una definizione parziale della classe ThisAddIn . Questa classe fornisce un punto di ingresso per il codice e fornisce l'accesso al modello a oggetti di Excel. Per altre informazioni, vedere Programmare componenti aggiuntivi VSTO. Il resto della ThisAddIn classe è definito in un file di codice nascosto che non è consigliabile modificare.

  • I gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown . Questi gestori eventi vengono chiamati quando Excel carica e scarica il componente aggiuntivo VSTO. Usare questi gestori eventi per inizializzare il componente aggiuntivo VSTO quando viene caricato e per eseguire la pulizia delle risorse usate dal componente aggiuntivo quando viene scaricato. Per altre informazioni, vedere Eventi nei progetti di Office.

Aggiungere una riga di testo alla cartella di lavoro salvata

  1. Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn . Il nuovo codice definisce un gestore eventi per l'evento WorkbookBeforeSave , che viene generato quando si salva una cartella di lavoro.

    Quando l'utente salva una cartella di lavoro, il gestore eventi aggiunge il nuovo testo all'inizio del foglio di lavoro attivo.

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

  2. Se si usa C#, aggiungere il seguente codice obbligatorio al gestore eventi ThisAddIn_Startup . Tale codice viene usato per connettere il gestore eventi Application_WorkbookBeforeSave all'evento WorkbookBeforeSave .

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

    Per modificare la cartella di lavoro salvata, gli esempi di codice precedenti usano i seguenti oggetti:

  • Il campo Application della classe ThisAddIn . Il campo Application restituisce un oggetto Application che rappresenta l'istanza corrente di Excel.

  • Il parametro Wb del gestore eventi dell'evento WorkbookBeforeSave . Il Wb parametro consiste in un oggetto Workbook che rappresenta la cartella di lavoro. Per altre informazioni, vedere Panoramica del modello a oggetti di Excel.

Testare il progetto

Per testare il progetto

  1. Premere F5 per compilare ed eseguire il progetto.

    Quando si crea il progetto, il codice viene compilato in un assembly incluso nella cartella di output di compilazione relativa al progetto. Visual Studio crea anche un set di voci del Registro di sistema che permettono a Excel di individuare e caricare il componente aggiuntivo VSTO e configura le impostazioni di sicurezza nel computer di sviluppo per permettere l'esecuzione del componente aggiuntivo VSTO. Per altre informazioni, vedere Creare soluzioni Office.

  2. In Excel, salvare la cartella di lavoro.

  3. Verificare che il seguente testo venga aggiunto alla cartella di lavoro.

    This text was added by using code.

  4. Chiudere Excel.

Pulire il progetto

Al termine dello sviluppo di un progetto, rimuovere l'assembly del componente aggiuntivo VSTO, le voci del Registro di sistema e le impostazioni di sicurezza dal computer di sviluppo. In caso contrario, il componente aggiuntivo VSTO continuerà a essere eseguito ogni volta che si apre Excel nel computer di sviluppo.

Per pulire il progetto completato nel computer di sviluppo

  1. In Visual Studio, nel menu Compila , fare clic su Pulisci soluzione.

Passaggi successivi

Dopo aver creato un componente aggiuntivo VSTO di base per Excel, è possibile visualizzare altre informazioni su come sviluppare componenti aggiuntivi VSTO in questi argomenti:

  • Attività di programmazione generali che è possibile eseguire nei componenti aggiuntivi VSTO: Programmare i componenti aggiuntivi VSTO.

  • Attività di programmazione specifiche dei componenti aggiuntivi VSTO di Excel: soluzioni Excel.

  • Uso del modello a oggetti di Excel: Panoramica del modello a oggetti di Excel.

  • Personalizzazione dell'interfaccia utente di Excel, ad esempio aggiungendo una scheda personalizzata alla barra multifunzione o creando un riquadro attività personalizzato: personalizzazione dell'interfaccia utente di Office.

  • Compilazione e debug di componenti aggiuntivi VSTO per Excel: Creare soluzioni Office.

  • Distribuzione di componenti aggiuntivi VSTO per Excel: distribuire una soluzione Office.

Contenuto correlato