Procedura dettagliata: creazione di un componente aggiuntivo a livello di applicazione per Excel

  • Articolo

In questa procedura dettagliata introduttiva viene illustrato come creare un componente aggiuntivo a livello di applicazione per Microsoft Office Excel.Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione indipendentemente da quali cartelle di lavoro vengano aperte.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Excel 2013 ed Excel 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

In questa procedura dettagliata vengono illustrate le attività seguenti:

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

  • Scrittura del codice che utilizza il modello a oggetti di Excel per aggiungere testo a una cartella di lavoro quando quest'ultima viene salvata.

  • Compilazione ed esecuzione del progetto per testarlo.

  • Pulitura del progetto completato affinché il componente aggiuntivo non venga più eseguito automaticamente nel computer di sviluppo.

[!NOTA]

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Prerequisiti

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

-

Una versione di Visual Studio 2012 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.110\).md).
  • Excel 2013 o Excel 2010.

Creazione del progetto

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

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu File, quindi fare clic su Progetto.

  3. Nel riquadro Modelli espandere, Visual C# o Visual Basicquindi espandere Office/SharePoint.

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

  5. Nell'elenco dei modelli di progetto selezionare Componente aggiuntivo di Excel 2010 o Componente aggiuntivo di Excel 2013.

  6. Nella casella Nome, digitare FirstExcelAddIn.

  7. Fare clic su OK.

    In Visual Studio viene creato il progetto FirstExcelAddIn e viene aperto il file di codice ThisAddIn nell'editor.

Scrittura del codice per aggiungere testo nella cartella di lavoro salvata

Successivamente, aggiungere codice al file di codice ThisAddIn.Il nuovo codice utilizza il modello a oggetti di Excel per inserire il boilerplate nella prima riga del foglio di lavoro attivo,ovvero quello aperto quando l'utente salva la cartella di lavoro.Per impostazione predefinita, nel file di codice ThisAddIn è contenuto il seguente codice generato:

  • Definizione parziale della classe ThisAddIn.Questa classe fornisce un punto di ingresso per il codice e consente di accedere al modello a oggetti di Excel.Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione.Il resto della classe ThisAddIn è definito in un file di codice nascosto che non deve essere modificato.

  • Gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown.Questi gestori eventi vengono chiamati quando il componente aggiuntivo viene caricato e scaricato da Excel.Possono essere utilizzati per inizializzare il componente aggiuntivo quando viene caricato e per liberare le risorse utilizzate dal componente aggiuntivo quando viene scaricato.Per ulteriori informazioni, vedere Eventi nei progetti di Office.

Per 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, 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.

    Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
    Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
    Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
    Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
    newFirstRow.Value2 = "This text was added by using code"
End Sub

    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 utilizza C#, aggiungere il codice richiesto indicato di seguito al gestore eventi ThisAddIn_Startup.Questo codice viene utilizzato 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 quando viene salvata, negli esempi di codice precedenti vengono utilizzati gli oggetti seguenti:

Verifica del progetto

Per verificare il progetto

  1. Premere F5 per compilare ed eseguire il progetto.

    Quando si compila il progetto, il codice viene compilato in un assembly che viene incluso nella cartella di output di compilazione del progetto.Visual Studio permette inoltre di creare un insieme di voci del Registro di sistema che consente a Excel di individuare e caricare il componente aggiuntivo e di configurare le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione del componente aggiuntivo.Per ulteriori informazioni, vedere Compilazione di soluzioni Office.

  2. In Excel, salvare la cartella di lavoro.

  3. Verificare che nella cartella di lavoro sia stato aggiunto il testo seguente.

    Questo testo è stato aggiunto tramite codice.

  4. Chiudere Excel.

Pulizia del progetto

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

Per pulire il progetto completato presente nel computer di sviluppo

  • In Visual Studio, nel menu Compila, scegliere Pulisci soluzione.

Passaggi successivi

Una volta creato un componente aggiuntivo di base a livello di applicazione per Excel, per acquisire ulteriori informazioni sullo sviluppo di componenti aggiuntivi è possibile consultare gli argomenti seguenti:

Vedere anche

Concetti

Cenni preliminari sullo sviluppo di soluzioni Office

Altre risorse

Soluzioni Excel

Programmazione di componenti aggiuntivi a livello di applicazione

Cenni preliminari sul modello a oggetti di Excel

Personalizzazione dell'interfaccia utente di Office

Compilazione di soluzioni Office

Distribuzione di una soluzione Office

Cenni preliminari sui modelli di progetto di Office