Elemento host foglio di lavoro

L'elemento host Worksheet è un tipo che estende il tipo Microsoft.Office.Interop.Excel.Worksheet dall'assembly di interoperabilità primario per Excel. L'elemento host Worksheet fornisce tutte le proprietà, i metodi e gli eventi come un oggetto Microsoft.Office.Interop.Excel.Worksheet, ma espone anche eventi aggiuntivi e agisce come un contenitore di controlli host e controlli Windows Form.

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, è possibile aggiungere gli elementi host Worksheet al progetto durante la fase di progettazione. Nei progetti a livello di applicazione è possibile generare elementi host Worksheet durante la fase di esecuzione.

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

Quando si crea un progetto a livello di documento per Excel, in Visual Studio vengono automaticamente creati tre elementi host Worksheet nel progetto. I nomi predefiniti dei fogli di lavoro sono Sheet1, Sheet2 e Sheet3. Se si crea un progetto basato su una cartella di lavoro esistente, il numero di elementi host dipenda dal numero di fogli di lavoro presenti nella cartella di lavoro.

Queste classi di elementi di lavoro consentono di accedere ai membri dell'elemento host Worksheet per eseguire attività di base della personalizzazione, ad esempio la modifica del contenuto in un foglio di lavoro. Queste classi possono inoltre essere utilizzate per aggiungere controlli e smart tag ai fogli di lavoro. Combinando opportunamente codice e diversi gruppi di controlli è possibile associare i controlli a dati, ottenere informazioni dall'utente e rispondere alle azioni dell'utente. Per ulteriori informazioni, vedere Programmazione delle personalizzazioni a livello di documento.

Le classi di fogli di lavoro rappresentano il punto di partenza da cui iniziare la scrittura di codice nel progetto. Poiché la classe fornisce tutte le proprietà, i metodi e gli eventi dell'oggetto Microsoft.Office.Interop.Excel.Worksheet nell'assembly di interoperabilità primario per Excel, è anche possibile utilizzare queste classi per accedere al modello a oggetti di Excel. Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti di Excel.

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

Ridenominazione dei fogli di lavoro

In un progetto a livello di documento è possibile rinominare i fogli di lavoro nella finestra di progettazione di Visual Studio; tuttavia, verrà modificato solo il nome visualizzato del foglio di lavoro. Il nome a livello di codice continuerà a essere il nome predefinito del foglio di lavoro. Se si rinomina il foglio di lavoro nella finestra Proprietà, verrà modificato solo il nome a livello di codice.

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

In un progetto a livello di documento non è possibile creare elementi host Worksheet durante la fase di esecuzione. Se si crea un nuovo foglio di lavoro di Excel durante la fase di esecuzione, sarà di tipo Microsoft.Office.Interop.Excel.Worksheet. Poiché non è un elemento host, non può contenere controlli host o controlli Windows Form. Per ulteriori informazioni sulla creazione di documenti in fase di esecuzione, vedere Procedura: aggiungere nuovi fogli di lavoro alle cartelle di lavoro.

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

Nei progetti a livello di applicazione, è possibile generare un elemento host Worksheet durante la fase di esecuzione per qualsiasi foglio di lavoro aperto in Excel. È possibile utilizzare l'elemento host Worksheet per aggiungere controlli e smart tag al foglio di lavoro associato o per gestire eventi non disponibili negli oggetti Microsoft.Office.Interop.Excel.Worksheet.

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

Vedere anche

Concetti

Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione

Aggiunta di controlli ai documenti di Office in fase di esecuzione

Cenni preliminari sugli elementi e sui controlli host

Elemento host cartella di lavoro

Automazione di Excel utilizzando oggetti estesi

Limitazioni a livello di codice degli elementi e dei controlli host

Altre risorse

Procedure dettagliate ed esempi di sviluppo di applicazioni per Microsoft Office

Controlli nei documenti di Office