Procedura dettagliata: creazione di una personalizzazione a livello di documento per Excel

Articolo
08/11/2011

In questa procedura dettagliata introduttiva viene illustrato come creare una personalizzazione a livello di documento per Microsoft Office Excel. Le funzionalità che si creano 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 utilizzata per apportare modifiche a un'intera applicazione, ad esempio per visualizzare una nuova scheda della barra multifunzione quando si apre una qualsiasi cartella di lavoro.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007 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 seguenti attività:

Creazione di un progetto cartella di lavoro di Excel.
Aggiunta di testo alla cartella di lavoro ospitata nella finestra di progettazione di Visual Studio.
Scrittura di codice che utilizza il modello a oggetti di Excel per aggiungere testo alla cartella di lavoro personalizzata quando quest'ultima viene aperta.
Compilazione ed esecuzione del progetto a scopo di verifica.
Pulizia del progetto completato per rimuovere dal computer di sviluppo le impostazioni di sicurezza e i file di compilazione non necessari.

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 2010 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.100\).md).

Microsoft Office Excel 2007 o Excel 2010.

Creazione del progetto

Per creare un nuovo progetto cartella di lavoro di Excel in Visual Studio

Avviare Visual Studio.
Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nel riquadro dei modelli espandere Visual C# o Visual Basic, quindi espandere Office.
In corrispondenza del nodo Office espanso, selezionare 2007 se è installato Excel 2007 o il nodo 2010 se è installato Excel 2010.
Nell'elenco dei modelli di progetto selezionare Cartella di lavoro di Excel 2007 o Cartella di lavoro di Excel 2010.
Nella casella Nome digitare FirstWorkbookCustomization.
Scegliere OK.

Verrà avviata la Creazione guidata progetto Visual Studio Tools per Office.
Selezionare Crea un nuovo documento e scegliere OK.
- In Visual Studio viene creato il progetto FirstWorkbookCustomization a cui vengono aggiunti i file seguenti.
- FirstWorkbookCustomization.xlsx: rappresenta la cartella di lavoro di Excel all'interno del progetto. Sono contenuti tutti i fogli di lavoro e i grafici.
- Foglio1 (file con estensione 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 ulteriori informazioni, vedere Elemento host foglio di lavoro.
- Foglio2 (file con estensione 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.
- Foglio3 (file con estensione 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 terzo foglio di lavoro della cartella di lavoro.
- ThisWorkbook (file VB per Visual Basic o file CS per Visual C#): contiene l'area di progettazione e il codice per le personalizzazioni a livello della cartella di lavoro. Per ulteriori informazioni, vedere Elemento host cartella di lavoro.
Il file di codice Sheet1 viene aperto automaticamente nella finestra di progettazione.

Chiusura e riapertura dei fogli di lavoro nella finestra di progettazione

La cartella o il foglio di lavoro chiuso intenzionalmente o accidentalmente nella finestra di progettazione mentre si sviluppa il progetto può essere riaperto.

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

Chiudere la cartella di lavoro scegliendo il pulsante Chiudi (X) della finestra di progettazione.
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul file di codice Sheet1, quindi scegliere Visualizza finestra di progettazione.

-oppure-

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

Aggiunta di testo a un foglio di lavoro nella finestra di progettazione

È possibile progettare l'interfaccia utente della personalizzazione modificando il foglio di lavoro che viene aperto nella finestra di progettazione. Ad esempio, è possibile inserire un testo nelle celle, applicare delle formule o aggiungere controlli Excel. Per ulteriori informazioni sull'utilizzo della finestra di progettazione, vedere Progetti di Office in ambiente Visual Studio.

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

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

Questo testo è stato aggiunto tramite la finestra di progettazione.

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

Aggiunta di testo a un foglio di lavoro a livello di codice

Successivamente, aggiungere codice al file di codice Sheet1. Nel nuovo codice viene utilizzato il modello a oggetti di Excel per aggiungere una seconda riga di testo alla cartella di lavoro. Per impostazione predefinita, nel file di codice Sheet1 è contenuto il seguente codice generato:

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 ulteriori informazioni, vedere Elemento host foglio di lavoro e Cenni preliminari sul modello a oggetti di Word. Il resto della classe Sheet1 è definito in un file di codice nascosto che non deve essere modificato.
Gestori eventi Sheet1_Startup e Sheet1_Shutdown. Questi gestori eventi vengono chiamati quando la personalizzazione viene caricata e scaricata da Excel. Possono essere utilizzati per inizializzare la personalizzazione quando viene caricata e per liberare le risorse utilizzate dalla personalizzazione quando viene scaricata. Per ulteriori informazioni, vedere Eventi nei progetti di Office.

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

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

Il file di codice viene aperto in Visual Studio.

Sostituire il gestore eventi Sheet1_Startup con il codice riportato di seguito. Quando il file Sheet1 viene aperto, questo codice consente di aggiungere una seconda riga di testo al foglio di lavoro.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
    nr.Value2 = "This text was added by using code"
End Sub

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

Verifica del progetto

Per testare la cartella di lavoro

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 consente di inserire una copia della cartella di lavoro e l'assembly nella cartella dell'output di compilazione del progetto e di configurare le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione della personalizzazione. Per ulteriori informazioni, vedere Cenni preliminari sul processo di compilazione delle soluzioni Office.
Nella cartella di lavoro, verificare che venga visualizzato il testo seguente.

Questo testo è stato aggiunto tramite la finestra di progettazione.

Questo testo è stato aggiunto tramite codice.
Chiudere la cartella di lavoro.

Pulitura del progetto

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

Per pulire il progetto completato contenuto nel computer di sviluppo

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

Passaggi successivi

Dopo aver creato una 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 generale eseguibili nelle personalizzazioni a livello di documento: Programmazione delle personalizzazioni a livello di documento.
Attività di programmazione specifiche delle personalizzazioni a livello di documento per Excel: Soluzioni Excel.
Utilizzo del modello a oggetti di Excel: Cenni preliminari sul modello a oggetti di Excel.
Personalizzazione dell'interfaccia utente di Excel, ad esempio tramite l'aggiunta di una scheda personalizzata alla barra multifunzione o la creazione di un riquadro azioni personalizzato: Personalizzazione dell'interfaccia utente di Office.
Utilizzo di oggetti di Excel estesi forniti dagli strumenti di sviluppo di Office in Visual Studio per eseguire attività che risultano impossibili tramite il modello a oggetti di Excel (ad esempio, l'hosting di controlli gestiti nei documenti e l'associazione di controlli Excel ai dati tramite il modello di associazione dati di Windows Form): Automazione di Excel utilizzando oggetti estesi.
Compilazione e debug di personalizzazioni a livello di documento per Excel: Compilazione e debug delle soluzioni Office.
Distribuzione di personalizzazioni a livello di documento per Excel: Distribuzione di soluzioni Office.