Élément hôte de classeur

L'élément Workbook hôte est un type qui étend le type Workbook de l'assembly d'interopérabilité principal pour Excel. L’élément Workbook hôte fournit toutes les mêmes propriétés, méthodes et événements en tant qu’objet 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 aux projets de complément VSTO pour Excel. Pour plus d’informations, 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 par défaut Workbook qui représente le classeur dans votre projet. Dans les projets de complément VSTO, vous pouvez générer Workbook des éléments hôtes au moment de l’exécution.

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

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

La ThisWorkbook classe fournit un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet. Étant donné que la classe fournit toutes les mêmes propriétés, méthodes et événements que l’objet Workbook dans l’assembly d’interopérabilité principal pour Excel, vous pouvez également utiliser ThisWorkbook pour accéder au modèle objet d’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 afficher les propriétés et les événements du classeur dans la fenêtre Propriétés .

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

Un projet au niveau du document ne peut contenir qu’un seul Workbook élément hôte (autrement dit, la ThisWorkbook classe). Vous ne pouvez pas ajouter de nouveaux Workbook éléments hôtes à votre projet au moment du design, et vous ne pouvez pas créer de nouveaux Workbook éléments hôtes 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 de type Workbook. Étant donné qu’il n’est pas un élément hôte, il ne peut pas contenir de contrôles hôtes ou de contrôles Windows Forms. Pour plus d’informations sur la création de classeurs au moment de l’exécution, consultez Guide pratique pour créer des classeurs par programmation.

L’élément Workbook hôte ne fait pas office de 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 se trouvent sous l'onglet Composant, l'onglet Données et All Windows Forms de la boîte à outils.

Comprendre les éléments d'hôte de classeurs dans les projets de compléments VSTO

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

Contenu connexe

• Exemples de développement Office et procédures pas à pas
• Étendre les documents Word et les classeurs Excel dans les compléments VSTO pendant l'exécution
• Vue d’ensemble des éléments hôtes et des contrôles hôtes
• Élément hôte de feuille de calcul
• Automatiser Excel à l’aide d’objets étendus
• Limitations programmatiques des éléments hôtes et des contrôles hôtes