Procedura dettagliata: Creare la prima personalizzazione a livello di documento per Excel

  • Articolo

Questa procedura dettagliata introduttiva mostra come creare una personalizzazione a livello di documento per Microsoft Office Excel. Le funzionalità create in questo tipo di soluzione sono disponibili solo quando si apre una cartella di lavoro specifica. Una personalizzazione a livello di documento non può essere usata per apportare modifiche a un'intera applicazione, ad esempio per visualizzare una nuova scheda della barra multifunzione quando si apre una cartella di lavoro qualsiasi.

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

In questa procedura dettagliata sono illustrati i task seguenti:

  • Creazione di un progetto cartella di lavoro di Excel.

  • Aggiunta di testo a un foglio di lavoro ospitato nella finestra di progettazione di Visual Studio.

  • Scrittura di codice che usa il modello a oggetti di Excel per aggiungere testo al foglio di lavoro personalizzato quando quest'ultimo viene aperta.

  • Creazione ed esecuzione del progetto a scopo di test.

  • Pulizia del progetto completato per rimuovere dal computer di sviluppo le impostazioni di sicurezza e i file di compilazione non necessari.

    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 cartella di lavoro di Excel in Visual Studio

  1. Avviare Visual Studio.

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

  3. Nella finestra di dialogo Crea un nuovo progetto selezionare il progetto Cartella di lavoro VSTO di Excel.

    Nota

    È anche possibile cercare modelli digitando il nome del prodotto Office nella casella di testo Cerca nella parte superiore della finestra di dialogo Crea un nuovo progetto . Ad esempio, digitando Excel verranno visualizzati tutti i modelli di progetto per Excel. È anche possibile filtrare l'elenco dei modelli per visualizzare solo i modelli per Office selezionando Office nella casella a discesa Tipo di progetto. Per altre informazioni, vedere Creare un nuovo progetto in Visual Studio.

  4. Fare clic su Avanti.

  5. Digitare FirstWorkbookCustomization nella casella Nome della finestra di dialogo Configura il nuovo progetto e fare clic su Crea.

  6. Selezionare Crea un nuovo documento nella Strumenti di Visual Studio creazione guidata progetto di Office e fare clic su OK.

    • Visual Studio crea il progetto FirstWorkbookCustomization e aggiunge i file seguenti al progetto.

    • FirstWorkbookCustomization.xlsx - Rappresenta la cartella di lavoro di Excel nel progetto. Contiene tutti i fogli di lavoro e i grafici.

    • Sheet1 (file vb per Visual Basic o file con estensione cs per Visual C#): foglio di lavoro che fornisce l'area di progettazione e il codice per il primo foglio di lavoro della cartella di lavoro. Per altre informazioni, vedere Elemento host del foglio di lavoro.

    • Sheet2 (file vb per Visual Basic o file con estensione cs per Visual C#): foglio di lavoro che fornisce l'area di progettazione e il codice per il secondo foglio di lavoro della cartella di lavoro.

    • Sheet3 (file con estensione vb per il file Visual Basic o cs per Visual C#): foglio di lavoro che fornisce l'area di progettazione e il codice per il terzo foglio di lavoro della cartella di lavoro.

    • ThisWorkbook (file con estensione vb per il file Visual Basic o cs per Visual C#): contiene l'area di progettazione e il codice per le personalizzazioni a livello di cartella di lavoro. Per altre informazioni, vedere Elemento host della cartella di lavoro.

      Il file di codice Sheet1 viene aperto automaticamente nella finestra di progettazione.

Chiudere e riaprire i fogli di lavoro nella finestra di progettazione

Se mentre si sviluppa il progetto si chiude intenzionalmente o accidentalmente una cartella di lavoro o un foglio di lavoro nella finestra di progettazione, è possibile riaprirlo.

Per chiudere e riaprire un foglio di lavoro nella finestra di progettazione

  1. Chiudere la cartella di lavoro facendo clic sul pulsante Chiudi (X) per la finestra di progettazione.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice Sheet1 e scegliere Progettazione viste.

    - oppure -

    In Esplora soluzioni fare doppio clic sul file di codice Sheet1.

Aggiungere testo a un foglio di lavoro nella finestra di progettazione

È possibile progettare l'interfaccia utente della personalizzazione modificando il foglio di lavoro aperto nella finestra di progettazione. Ad esempio, è possibile aggiungere testo alle celle, applicare formule o aggiungere controlli di Excel. Per altre informazioni su come usare la finestra di progettazione, vedere Progetti di Office nell'ambiente Visual Studio.

Per aggiungere testo a un foglio di lavoro mediante la finestra di progettazione

  1. Nel foglio di lavoro aperto nella finestra di progettazione selezionare la cella A1 e quindi digitare il testo seguente.

    Questo testo è stato aggiunto tramite la finestra di progettazione.

Avviso

Se si aggiunge questa riga di testo alla cella A2, verrà sovrascritta da altro codice in questo esempio.

Aggiungere testo a un foglio di lavoro a livello di codice

Aggiungere quindi codice al file di codice Sheet1. Il nuovo codice usa il modello a oggetti di Excel per aggiungere nella cartella di lavoro una seconda riga di testo. Per impostazione predefinita, il file di codice Sheet1 contiene il seguente codice generato:

  • Una definizione parziale della classe Sheet1, che rappresenta il modello di programmazione del foglio di lavoro e consente di accedere al modello a oggetti di Excel. Per altre informazioni, panoramica dell'elemento host del foglio di lavoro e del modello a oggetti di Word. Il resto della classe Sheet1 viene definito in un file di codice nascosto che l'utente non deve modificare.

  • I gestori eventi Sheet1_Startup e Sheet1_Shutdown . Questi gestori eventi vengono chiamati quando Excel carica e scarica la personalizzazione. Usare questi gestori eventi per inizializzare la personalizzazione quando viene caricata e per eseguire la pulizia delle risorse usate dalla personalizzazione quando viene scaricata. Per altre informazioni, vedere Eventi nei progetti di Office.

Per aggiungere al foglio di lavoro una seconda riga di codice mediante codice

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su Sheet1 e quindi scegliere Visualizza codice.

    Il file di codice verrà aperto in Visual Studio.

  2. Sostituire il gestore eventi Sheet1_Startup con il codice seguente. Quando viene aperto il foglio Sheet1, questo codice aggiunge una seconda riga di testo al foglio di lavoro.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testare il progetto

Per testare la cartella di lavoro

  1. Premere F5 per compilare ed eseguire il progetto.

    Quando si compila il progetto, il codice viene compilato in un assembly associato alla cartella di lavoro. Visual Studio inserisce una copia della cartella di lavoro e l'assembly nella cartella dell'output di compilazione del progetto e configura le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione della personalizzazione. Per altre informazioni, vedere Creare soluzioni Office.

  2. Nella cartella di lavoro verificare che sia visualizzato il testo seguente.

    Questo testo è stato aggiunto tramite la finestra di progettazione.

    This text was added by using code.

  3. Chiudi la cartella di lavoro.

Pulire il progetto

Al termine dello sviluppo di un progetto, è necessario rimuovere le impostazioni di sicurezza e i file contenuti nella cartella dell'output di compilazione creati dal processo di compilazione.

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 questa personalizzazione di base a livello di documento per Excel, per approfondire le proprie conoscenze sullo sviluppo di personalizzazioni è possibile consultare gli argomenti seguenti:

  • Attività di programmazione generali che è possibile eseguire nelle personalizzazioni a livello di documento: programmare personalizzazioni a livello di documento.

  • Attività di programmazione specifiche per le personalizzazioni a livello di documento per 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 azioni personalizzato: personalizzazione dell'interfaccia utente di Office.

  • Utilizzo di oggetti Excel estesi forniti dagli strumenti di sviluppo di Office in Visual Studio per eseguire attività che non sono possibili usando il modello a oggetti di Excel, ad esempio l'hosting di controlli gestiti su documenti e l'associazione di controlli excel ai dati tramite il modello di data binding Windows Form: automatizzare Excel usando oggetti estesi.

  • Compilazione e debug di personalizzazioni a livello di documento per Excel: Creare soluzioni Office.

  • Distribuzione di personalizzazioni a livello di documento per Excel: Distribuire una soluzione Office.

Contenuto correlato