Partager via


Élément hôte de feuille de calcul

L’élément hôte Worksheet est un type qui étend le type Worksheet à partir de l’assembly PIA (Primary Interop Assembly) pour Excel. L’élément hôte Worksheet fournit les mêmes propriétés, méthodes et événements qu’un objet Worksheet , mais il expose également des événements supplémentaires et agit comme conteneur pour les contrôles hôtes et les contrôles Windows Forms.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO pour Excel. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

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 de compléments VSTO, 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 dans les projets au niveau du document

Quand 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. Les noms par défaut des feuilles de calcul sont Sheet1, Sheet2et 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 dans le 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 aussi utiliser ces classes pour ajouter des contrôles à des feuilles de calcul. En combinant plusieurs jeux de contrôles et en écrivant du code, vous pouvez lier les contrôles à des données, recueillir des informations de l’utilisateur et répondre à des actions utilisateur. Pour plus d’informations, consultez Les personnalisations au niveau du document du programme.

Les classes de feuille de calcul fournissent 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 que l’objet Worksheet dans l’assembly PIA pour Excel, vous pouvez aussi utiliser ces classes pour accéder au modèle objet d’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 dans le concepteur.

Renommer des feuilles de calcul

Dans un projet au niveau du document, vous pouvez renommer les feuilles de calcul dans le concepteur Visual Studio, mais cela modifie uniquement le nom d’affichage 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 de type Worksheet. Comme il ne s’agit pas d’un élément hôte, il ne peut pas contenir de contrôles hôtes ni de contrôles Windows Forms. Pour plus d’informations sur la création de documents au moment de l’exécution, consultez Guide pratique pour ajouter par programmation de nouvelles feuilles de calcul aux classeurs.

Comprendre les éléments hôtes de feuille de calcul dans les projets de complément VSTO

Dans les projets de niveau 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 à la feuille de calcul associée ou pour gérer des événements qui ne sont pas disponibles sur des objets Worksheet .

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