Modello di progetto Modello di Excel

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Versione Microsoft Office Excel 2007 Excel 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Sul modello di progetto Modello di Excel in Visual Basic e Visual C# si fondano le soluzioni basate su modelli nuovi o esistenti di Microsoft Office Excel. Sono disponibili diversi modelli di progetto per i modelli di Excel 2003 ed Excel 2007. Nei modelli di progetto vengono aggiunti automaticamente i riferimenti all'assembly, i file e il codice generato necessari, da utilizzare come punto di partenza per la creazione della soluzione.

Se si apre un modello per modificarlo all'esterno di Visual Studio una volta che la soluzione è stata compilata, il codice verrà eseguito nel modello, in maniera analoga a quanto avviene per la creazione di un nuovo documento da un modello. A seconda del codice, il modello può subire modifiche al momento dell'apertura, prima che inizi la modifica. Per impedire l'esecuzione del codice, tenere premuto il tasto MAIUSC durante l'apertura del modello.

Nota:
Per impostazione predefinita, alcuni dei file e dei riferimenti inclusi nell'elenco seguente sono nascosti. Per visualizzarli, fare clic su Mostra tutti i file sulla barra degli strumenti Esplora soluzioni. Vi sono inoltre alcuni file e riferimenti comuni a molti modelli di progetto di Visual Studio non inclusi nell'elenco.

File

In Visual Studio Tools per Office vengono generati i seguenti file visibili nei progetti modello di Excel 2003 ed Excel 2007:

• Nome cartella di lavoro.xls: indica la cartella di lavoro di Excel all'interno del progetto. Contiene 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 la classe 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 la classe Elemento host cartella di lavoro.

Nota:
Non è possibile aggiungere ulteriori classi al file di codice di un documento, di una cartella di lavoro o di un foglio di lavoro. È necessario aggiungere nuovi file al progetto per poter contenere le classi che si intende scrivere.

In Visual Studio Tools per Office, nella compilazione di un progetto modello di Excel 2007 viene inoltre generato il file aggiuntivo seguente:

• Nome progetto_TemporaryKey.pfx - Certificato temporaneo utilizzabile per la firma dei manifesti dell'applicazione e dei manifesti di distribuzione per il progetto durante lo sviluppo. Per ulteriori informazioni, vedere Concessione dell'attendibilità alle soluzioni Office (2007 System) e Sicurezza nelle soluzioni Office (System 2007).

File nascosti

In Visual Studio Tools per Office vengono generati diversi file nascosti. Non modificare manualmente questi file; essi sono rigenerati quando vengono apportate modifiche al progetto e non conservano le modifiche manuali.

In Visual Studio Tools per Office vengono generati i file nascosti seguenti:

• ThisWorkbook.Designer.xml - Rappresentazione dichiarativa di sola lettura degli oggetti programmabili nella cartella di lavoro.

• ThisWorkbook.Designer (con estensione VB o CS) - File di codice di sola lettura che fornisce implementazioni delle funzioni di supporto per gli oggetti contenuti nella cartella di lavoro, incluso il codice per creare correttamente istanze degli oggetti.

• Sheetn.Designer.xml - Rappresentazione dichiarativa di sola lettura degli oggetti programmabili nel foglio di lavoro.

• Sheetn.Designer (con estensione VB o CS) - File di codice di sola lettura che fornisce implementazioni delle funzioni di supporto per gli oggetti contenuti nel foglio di lavoro, incluso il codice per creare correttamente istanze degli oggetti.

• Nome cartella di lavoro.Designer.xml - Rappresentazione dichiarativa di sola lettura degli oggetti programmabili come i controlli personalizzati, che per impostazione predefinita non fanno parte di Visual Studio Tools per Office. Il file viene generato in caso di aggiunta di un controllo personalizzato a un foglio di lavoro nella cartella di lavoro.

• Nome cartella di lavoro.Designer (con estensione VB o CS) - File di codice di sola lettura che fornisce implementazioni delle funzioni di supporto per controlli personalizzati. Il file viene generato in caso di aggiunta di un controllo personalizzato a un foglio di lavoro nella cartella di lavoro.

Codice del modello

I gestori eventi riportati di seguito sono inclusi nei file di codice del modello di progetto. Per ulteriori informazioni, vedere Eventi di progetti Visual Studio Tools per Office.

Gestori di eventi Startup

Gestiscono gli eventi Workbook.Startup e Worksheet.Startup. Tali eventi vengono generati per ciascun foglio di lavoro e per la cartella di lavoro quando la soluzione è in esecuzione e tutto il codice di inizializzazione nell'assembly è stato eseguito. Utilizzare questi gestori eventi per eseguire il codice di inizializzazione della soluzione.

I gestori di eventi Startup contenuti in una soluzione di modello vengono chiamati nel seguente ordine:

1. ThisWorkbook_Startup.

2. Sheet1_Startup.

3. Sheet2_Startup.

4. Sheet3_Startup.

5. Altri fogli di lavoro nell'ordine.

L'ordine è determinato al momento della compilazione del progetto. Se l'utente riorganizza i fogli di lavoro in fase di esecuzione, questa operazione non modifica l'ordine di generazione degli eventi alla successiva apertura della cartella di lavoro.

Gestori di eventi Shutdown

Gestiscono gli eventi Workbook.Shutdown e Worksheet.Shutdown. Tali eventi vengono generati per ciascun foglio di lavoro e per la cartella di lavoro quando il dominio dell'applicazione in cui è caricato il codice sta per essere scaricato.

I gestori di eventi Shutdown contenuti in una soluzione di modello vengono chiamati nel seguente ordine:

1. ThisWorkbook_Shutdown.

2. Sheet1_Shutdown.

3. Sheet2_Shutdown.

4. Sheet3_Shutdown.

5. Altri fogli di lavoro nell'ordine.

Riferimenti

In Visual Studio Tools per Office viene creato automaticamente un insieme di riferimenti ad assembly nei progetti modello di Excel. Nei riferimenti sono inclusi gli assembly seguenti:

• Assembly nel runtime di Visual Studio Tools per Office. Per ulteriori informazioni su questi assembly, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

• Assembly di interoperabilità primari per componenti di Office condivisi ed Excel. Per ulteriori informazioni, vedere Assembly di interoperabilità primari di Office.

• Assembly di .NET Framework utilizzati durante lo sviluppo di soluzioni Visual Studio Tools per Office.

Vedere anche

Attività

Procedura: creare progetti Visual Studio Tools per Office

Concetti

Limitazioni dei modelli globali e dei componenti aggiuntivi di Excel (file xla)

Cenni preliminari sugli assembly nelle soluzioni Office

Cenni preliminari sul modello a oggetti di Excel

Altre risorse

Gestione di soluzioni, progetti e file

Modelli di progetto di Office