Élément hôte de feuille de calcul

L'élément Worksheet hôte est un type qui étend le type Worksheet de l'assembly d'interopérabilité principal pour Excel. L’élément Worksheet hôte fournit toutes les mêmes propriétés, méthodes et événements en tant qu’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 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, vous pouvez ajouter Worksheet des éléments hôtes à votre projet au moment du design. Dans les projets de complément VSTO, vous pouvez générer Worksheet des éléments hôtes au moment de l’exécution.

Comprendre les éléments hôtes de feuille de travail dans les projets de niveau document

Lorsque vous créez un projet au niveau du document pour Excel, Visual Studio crée automatiquement trois Worksheet éléments hôtes 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 permettent d’accéder aux membres de l’élément Worksheet hôte 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 à des feuilles de calcul. En combinant différents ensembles de contrôles et d’écriture de code, vous pouvez lier les contrôles aux données, collecter des informations de l’utilisateur et répondre aux actions de l’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 toutes les mêmes propriétés, méthodes et événements que l’objet Worksheet dans l’assembly d’interopérabilité principal pour Excel, vous pouvez également 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 supplémentaires Worksheet au projet durant la phase de conception 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 complet de la feuille de calcul. Le nom programmatique est toujours 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 programme 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 de nouveaux Worksheet éléments hôtes 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. É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 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 VSTO Add-in

Dans les projets au niveau de l’application, vous pouvez générer un Worksheet élément hôte au moment de l’exécution pour toute feuille de calcul ouverte dans Excel. Vous pouvez utiliser l’élément Worksheet hôte pour ajouter des contrôles à la feuille de calcul associée ou pour gérer les événements qui ne sont pas disponibles sur Worksheet les objets.

Pour générer un Worksheet é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
• Contrôles sur les documents Office
• Ajouter des contrôles aux documents Office au moment de l’exécution
• Vue d’ensemble des éléments hôtes et des contrôles hôtes
• Élément hôte de classeur
• Automatiser Excel à l’aide d’objets étendus
• Limitations programmatiques des éléments hôtes et des contrôles hôtes