Elemento host foglio di lavoro

  • Articolo

L'elemento host Worksheet è un tipo che estende il tipo Worksheet dall'assembly di interoperabilità primario per Excel. L'elemento host Worksheet offre tutte le stesse proprietà, gli stessi metodi ed eventi di un oggetto Worksheet , ma espone anche eventi aggiuntivi e funge da contenitore per i controlli host e quelli Windows Form.

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 è possibile aggiungere elementi host Worksheet al progetto in fase di progettazione. Nei progetti di componente aggiuntivo VSTO è possibile generare elementi host Worksheet in fase di esecuzione.

Informazioni sugli elementi host del foglio di lavoro nei progetti a livello di documento

Quando si crea un progetto a livello di documento per Excel, Visual Studio automaticamente crea tre elementi host Worksheet nel progetto. I nomi predefiniti dei fogli di lavoro sono Sheet1, Sheet2e Sheet3. Se si crea un progetto in base a una cartella di lavoro esistente, il numero di elementi host dipende dal numero di fogli di lavoro nella cartella di lavoro.

Queste classi del foglio di lavoro offrono l'accesso ai membri dell'elemento host Worksheet per eseguire attività di base nella personalizzazione, come ad esempio la modifica dei contenuti in un foglio di lavoro. È anche possibile usare queste classi per aggiungere controlli ai fogli di lavoro. Con la combinazione di set di controlli diversi e con la scrittura di codice, è possibile associare i controlli ai dati, raccogliere le informazioni relative all'utente e rispondere alle azioni utente. Per altre informazioni, vedere Programmare personalizzazioni a livello di documento.

Le classi del foglio di lavoro offrono 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 Worksheet nell'assembly di interoperabilità primario per Excel, è possibile usare anche queste classi per accedere al modello a oggetti di Excel. Per altre informazioni, vedere Panoramica del modello a oggetti di Excel.

Nei progetti a livello di documento è possibile aggiungere elementi host Worksheet aggiuntivi al progetto in fase di progettazione aggiungendo un nuovo foglio di lavoro nella finestra di progettazione.

Rinominare i fogli di lavoro

In un progetto a livello di documento è possibile rinominare i fogli di lavoro nella finestra di progettazione di Visual Studio, ma in tal modo viene modificato solo il nome visualizzato del foglio di lavoro. Il nome a livello di codice rimane il nome predefinito del foglio di lavoro. Se si rinomina il foglio di lavoro nella finestra Proprietà , viene modificato solo il nome a livello di codice.

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

Non è possibile creare nuovi elementi host Worksheet in fase di esecuzione in un progetto a livello di documento. Se si crea un nuovo foglio di lavoro Excel in fase di esecuzione, sarà di tipo Worksheet. 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 documenti in fase di esecuzione, vedere Procedura: Aggiungere nuovi fogli di lavoro a livello di codice alle cartelle di lavoro.

Informazioni sugli elementi host del foglio di lavoro nei progetti di componente aggiuntivo VSTO

Nei progetti a livello di applicazione è possibile generare un elemento host Worksheet in fase di esecuzione per qualsiasi foglio di lavoro in Excel. È possibile usare l'elemento host Worksheet per aggiungere controlli al foglio di lavoro associato oppure per gestire eventi che non sono disponibili su oggetti Worksheet .

Per generare un elemento host Worksheet, 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