Elemento host cartella di lavoro

L'elemento host Workbook è un tipo che estende il tipo Workbook dall'assembly di interoperabilità primario per Excel. L'elemento host Workbook fornisce non solo tutte le proprietà, i metodi e gli eventi di un oggetto Workbook , ma anche funzionalità aggiuntive.

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

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

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

Per accedere alla cartella di lavoro nel progetto, usare la classe ThisWorkbook . La classe ThisWorkbook consente l'accesso ai membri dell'elemento host Workbook per eseguire attività di base nella personalizzazione, ad esempio eseguire codice quando la cartella di lavoro è aperta o chiusa. Per altre informazioni, vedere Programmare personalizzazioni a livello di documento.

La classe ThisWorkbook offre un punto di partenza per iniziare a scrivere codice nel progetto. Dal momento che la classe offre tutte le stesse proprietà, gli stessi metodi ed eventi dell'oggetto Workbook nell'assembly di interoperabilità primario per Excel, è possibile usare anche ThisWorkbook per accedere al modello a oggetti di Excel. Per altre informazioni, vedere Panoramica del modello a oggetti di Excel.

Fare doppio clic sul 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 della cartella di lavoro nei progetti a livello di documento

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

Se si crea una nuova cartella di lavoro di Excel in fase di esecuzione, sarà di tipo Workbook. Dal momento che non si tratta di un elemento host, non può contenere alcun controllo host o controllo Windows Form. Per altre informazioni sulla creazione di cartelle di lavoro in fase di esecuzione, vedere Procedura: Creare nuove cartelle di lavoro a livello di codice.

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.

Informazioni sugli elementi host della cartella di lavoro nei progetti di componente aggiuntivo VSTO

Nei progetti di componente aggiuntivo VSTO è possibile generare un elemento host Workbook in fase di esecuzione per qualsiasi cartella di lavoro aperta in Excel. Per generare un elemento host Workbook, usare il metodo GetVstoObject. Per altre informazioni, vedere Estendere documenti di Word e cartelle di lavoro di Excel nei componenti aggiuntivi VSTO in fase di esecuzione.

Contenuto correlato

• Esempi di sviluppo e procedure dettagliate per Office
• Estendere i documenti di Word e le cartelle di lavoro di Excel nei componenti aggiuntivi VSTO in fase di esecuzione
• Panoramica degli elementi host e dei controlli host
• Elemento host foglio di lavoro
• Automatizzare Excel usando oggetti estesi
• Limitazioni a livello di codice degli elementi host e dei controlli host