Élément hôte de feuille de calcul
L'élément hôte Worksheet est un type qui étend le type Microsoft.Office.Interop.Excel.Worksheet de l'assembly PIA pour Excel. L'élément hôte Worksheet fournit les mêmes propriétés, méthodes et événements qu'un objet Microsoft.Office.Interop.Excel.Worksheet, mais expose en plus des événements supplémentaires et joue le rôle de conteneur pour les contrôles hôtes et Windows Forms.
S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Excel 2007 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, vous pouvez ajouter des éléments hôtes Worksheet à votre projet au moment du design. Dans les projets au niveau de l'application, vous pouvez générer des éléments hôtes Worksheet au moment de l'exécution.
Comprendre les éléments hôtes de feuille de calcul des projets au niveau du document
Lorsque vous créez un projet au niveau du document pour Excel, Visual Studio crée automatiquement trois éléments hôtes Worksheet dans le projet. Par défaut, les noms des feuilles de calcul sont Sheet1, Sheet2 et Sheet3. Si vous créez un projet basé sur un classeur existant, le nombre d'éléments hôtes dépend du nombre de feuilles de calcul du classeur.
Ces classes de feuille de calcul vous donnent accès aux membres de l'élément hôte Worksheet pour effectuer des tâches de base dans votre personnalisation, telles que la modification du contenu d'une feuille de calcul. Vous pouvez également utiliser ces classes pour ajouter des contrôles et des balises actives aux feuilles de calcul. En combinant plusieurs jeux de contrôles et en écrivant du code, vous pouvez lier les contrôles aux données, rassembler des informations auprès de l'utilisateur et répondre aux actions de celui-ci. Pour plus d'informations, consultez Programmation de personnalisations au niveau du document.
Notes
Les balises actives sont déconseillées dans Excel 2010 et Word 2010. Pour plus d'informations, consultez Vue d'ensemble des balises actives.
Les classes de feuille de calcul fournissent un emplacement dans lequel vous pouvez commencer à écrire du code pour 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.Worksheet dans l'assembly PIA pour Excel, vous pouvez également utiliser ces classes pour accéder au modèle objet Excel. Pour plus d'informations, consultez Vue d'ensemble du modèle objet Excel.
Dans les projets au niveau du document, vous pouvez ajouter des éléments hôtes Worksheet supplémentaires au projet au moment du design en ajoutant une nouvelle feuille de calcul au classeur depuis le concepteur.
Attribution d'un nouveau nom aux feuilles de calcul
Dans un projet au niveau du document, vous pouvez renommer les feuilles de calcul depuis le concepteur Visual Studio, mais cela modifie uniquement le nom complet de la feuille de calcul. Le nom de programmation est encore le nom par défaut de la feuille de calcul. Si vous renommez la feuille de calcul dans la fenêtre Propriétés, seul le nom de programmation est modifié.
Limitations de l'élément hôte de feuille de calcul dans les projets au niveau du document
Vous ne pouvez pas créer d'éléments hôtes Worksheet au moment de l'exécution dans un projet au niveau du document. Si vous créez une feuille de calcul Excel au moment de l'exécution, elle sera du type Microsoft.Office.Interop.Excel.Worksheet. 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 documents au moment de l'exécution, consultez Comment : ajouter des feuilles de calcul à des classeurs.
Comprendre les éléments hôtes de feuille de calcul 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 Worksheet au moment de l'exécution pour toute feuille de calcul ouverte dans Excel. Vous pouvez utiliser l'élément hôte Worksheet pour ajouter des contrôles et des balises actives à la feuille de calcul associée ou gérer des événements qui ne sont pas disponibles sur les objets Microsoft.Office.Interop.Excel.Worksheet.
Pour générer un élément hôte Worksheet, 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..
Voir aussi
Concepts
Ajout de contrôles à des documents Office au moment de l'exécution
Vue d'ensemble des éléments hôtes et des contrôles hôtes
Automatisation d'Excel à l'aide d'objets étendus
Limitations de programmation des éléments hôtes et des contrôles hôtes
Autres ressources
Exemples et procédures pas à pas relatifs au développement Office