Élément hôte de classeur

Article
03/04/2013

L'élément hôte Workbook est un type qui étend le type Microsoft.Office.Interop.Excel.Workbook de l'assembly PIA pour Excel.L'élément hôte Workbook fournit les mêmes propriétés, méthodes et événements qu'un objet Microsoft.Office.Interop.Excel.Workbook, mais il fournit également des fonctionnalités supplémentaires.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Excel 2013 et Excel 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Dans les projets au niveau du document, il existe un élément hôte Workbook par défaut qui représente le classeur de votre projet.Dans les projets au niveau de l'application, vous pouvez générer des éléments hôtes Workbook au moment de l'exécution.

Comprendre l'élément hôte de classeur dans les projets au niveau du document

Pour accéder au classeur de votre projet, utilisez la classe ThisWorkbook.La classe ThisWorkbook vous donne accès aux membres de l'élément hôte Workbook pour effectuer des tâches de base dans votre personnalisation, telles que l'exécution du code lors de l'ouverture ou de la fermeture du classeur.Pour plus d’informations, consultez Programmation de personnalisations au niveau du document.

La classe ThisWorkbook fournit un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet.Étant donné que la classe fournit les mêmes propriétés, méthodes et événements qu'un objet Microsoft.Office.Interop.Excel.Workbook dans l'assembly PIA pour Excel, vous pouvez également utiliser ThisWorkbook pour accéder au modèle objet Excel.Pour plus d’informations, consultez Vue d'ensemble du modèle objet Excel.

Double-cliquez sur l'élément de projet ThisWorkbook dans l'Explorateur de solutions pour afficher le concepteur de classeurs et consulter les propriétés et événements du classeur dans la fenêtre Propriétés.

Limitations de l'élément hôte de classeur dans les projets au niveau du document

Un projet au niveau du document peut contenir un seul élément hôte Workbook (c'est-à-dire la classe ThisWorkbook).Vous ne pouvez pas ajouter de nouveaux éléments hôtes Workbook à votre projet au moment du design et ne pouvez pas non plus créer d'éléments hôtes Workbook au moment de l'exécution à partir d'une personnalisation au niveau du document.

Si vous créez un classeur Excel au moment de l'exécution, il sera du type Microsoft.Office.Interop.Excel.Workbook.Comme il ne s'agit pas d'un élément hôte, il ne peut contenir aucun contrôle hôte ni aucun contrôle Windows Forms.Pour plus d'informations sur la création de classeurs au moment de l'exécution, consultez Comment : créer des classeurs par programmation.

L'élément hôte Workbook n'agit pas comme un conteneur pour les contrôles hôtes.Par conséquent, vous ne pouvez pas ajouter de contrôles visibles au classeur, mais vous pouvez ajouter des composants, tels qu'un DataSet, afin que les composants puissent être partagés par toutes les feuilles de calcul.Dans un projet au niveau du document, les composants disponibles pour le classeur sont accessibles depuis l'onglet Composant, l'onglet Données et l'onglet Tous les Windows Forms de la boîte à outils.

[!REMARQUE]

Les outils de développement Office de Visual Studio ne prennent pas en charge les classeurs partagés.

Comprendre les éléments hôtes de classeur dans les projets au niveau de l'application

Dans les projets au niveau de l'application, vous pouvez générer un élément hôte Workbook au moment de l'exécution pour tout classeur ouvert dans Excel.Pour générer un élément hôte Workbook, utilisez la méthode GetVstoObject.Pour plus d’informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..