Elemento host cartella di lavoro

Articolo
08/11/2011

L'elemento host Workbook è un tipo che estende il tipo Microsoft.Office.Interop.Excel.Workbook dall'assembly di interoperabilità primario per Excel. L'elemento host Workbook fornisce gli stessi metodi, gli stessi eventi e le stesse proprietà di un oggetto Microsoft.Office.Interop.Excel.Workbook oltre a funzionalità aggiuntive.

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

Nei progetti a livello di documento è presente un elemento host Workbook predefinito che rappresenta la cartella di lavoro nel progetto. Nei progetti a livello di applicazione è possibile generare elementi host Workbook in fase di esecuzione.

Informazioni sull'elemento host cartella di lavoro dei progetti a livello di documento

Per accedere alla cartella di lavoro nel progetto, utilizzare la classe ThisWorkbook. La classe ThisWorkbook consente l'accesso dell'utente ai membri dell'elemento host Workbook per eseguire attività di base nella personalizzazione, ad esempio l'esecuzione di codice all'apertura o alla chiusura della cartella di lavoro. Per ulteriori informazioni, vedere Programmazione delle personalizzazioni a livello di documento.

La classe ThisWorkbook fornisce un punto di partenza da cui iniziare a scrivere il codice per il progetto. Poiché la classe fornisce tutte le proprietà, i metodi e gli eventi dell'oggetto Microsoft.Office.Interop.Excel.Workbook nell'assembly di interoperabilità primario per Excel, è anche possibile utilizzare ThisWorkbook per accedere al modello a oggetti di Excel. Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti di Excel.

Fare doppio clic sull'elemento di progetto ThisWorkbook in Esplora soluzioni per visualizzare la finestra di progettazione della cartella di lavoro e vedere le proprietà e gli eventi della cartella di lavoro nella finestra Proprietà.

Limitazioni dell'elemento host cartella di lavoro nei progetti a livello di documento

Un progetto a livello di documento può contenere un solo elemento host Workbook (ovvero la classe ThisWorkbook ). Non è possibile aggiungere in fase di progettazione nuovi elementi host Workbook al progetto, né creare in fase di esecuzione nuovi elementi host Workbook a partire da una personalizzazione a livello di documento.

Se si crea una nuova cartella di lavoro di Excel in fase di esecuzione, sarà di tipo Microsoft.Office.Interop.Excel.Workbook. Poiché non è un elemento host, non può contenere controlli host o controlli Windows Form. Per ulteriori informazioni sulla creazione di cartelle di lavoro in fase di esecuzione, vedere Procedura: creare nuove cartelle di lavoro.

L'elemento host Workbook non funge da contenitore per i controlli host. Pertanto, alla cartella di lavoro non è possibile aggiungere controlli visibili, ma si possono inserire componenti, ad esempio DataSet, in modo che possano essere condivisi da tutte le cartelle di lavoro. In un progetto a livello di documento, i componenti disponibili per la cartella di lavoro sono reperibili nelle schede Componente, Dati e Tutti i Windows Form della Casella degli strumenti.

Nota

Gli strumenti di sviluppo di Office in Visual Studio non supportano le cartelle di lavoro condivise.

Informazioni sugli elementi host cartella di lavoro nei progetti a livello di applicazione

Nei progetti a livello di applicazione è possibile generare un elemento host Workbook in fase di esecuzione per qualsiasi cartella di lavoro aperta in Excel. Per generare un elemento host Workbook, utilizzare il metodo GetVstoObject. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.