Élément hôte de feuille de calculWorksheet Host Item

L’élément hôte Worksheet est un type qui étend le type Worksheet à partir de l’assembly PIA (Primary Interop Assembly) pour Excel.The Worksheet host item is a type that extends the Worksheet type from the primary interop assembly for 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.The Worksheet host item provides all of the same properties, methods, and events as a Worksheet object, but it also exposes additional events and acts as a container for host controls and Windows Forms controls.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document et aux projets de compléments VSTO pour Excel.Applies to: The information in this topic applies to document-level projects and VSTO add-in projects for Excel. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Dans les projets au niveau du document, vous pouvez ajouter des éléments hôtes Worksheet à votre projet au moment du design.In document-level projects, you can add Worksheet host items to your project at design time. Dans les projets de compléments VSTO, vous pouvez générer des éléments hôtes Worksheet au moment de l'exécution.In VSTO Add-in projects, you can generate Worksheet host items at run time.

Présentation des éléments hôtes Worksheet dans les projets au niveau du documentUnderstanding Worksheet Host Items in Document-Level Projects

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.When you create a document-level project for Excel, Visual Studio automatically creates three Worksheet host items in the project. Les noms par défaut des feuilles de calcul sont Sheet1, Sheet2et Sheet3.The default names of the worksheets are Sheet1, Sheet2, and 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.If you create a project based on an existing workbook, the number of host items depends on the number of worksheets in the workbook.

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.These worksheet classes give you access to members of the Worksheet host item to perform basic tasks in your customization, such as modifying the contents of a worksheet. Vous pouvez aussi utiliser ces classes pour ajouter des contrôles à des feuilles de calcul.You can also use these classes to add controls to worksheets. 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.By combining different sets of controls and writing code, you can bind the controls to data, collect information from the user, and respond to user actions. Pour plus d'informations, consultez Programming Document-Level Customizations.For more information, see Programming Document-Level Customizations.

Les classes de feuille de calcul fournissent un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet.The worksheet classes provide a location in which you can start writing code in your project. É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.Because the class provides all of the same properties, methods, and events as the Worksheet object in the primary interop assembly for Excel, you can also use these classes to access the object model of Excel. Pour plus d'informations, consultez Excel Object Model Overview.For more information, see Excel Object Model Overview.

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.In document-level projects, you can add additional Worksheet host items to the project at design time by adding a new worksheet to the workbook in the designer.

Modification du nom des feuilles de calculRenaming Worksheets

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.In a document-level project, you can rename the worksheets in the Visual Studio designer, but this only changes the display name of the worksheet. Le nom de programmation est encore le nom par défaut de la feuille de calcul.The programmatic name is still the default name of the worksheet. Si vous renommez la feuille de calcul dans la fenêtre Propriétés , seul le nom de programmation est modifié.If you rename the worksheet in the Properties window, only the programmatic name is changed.

Limitations de l’élément hôte Worksheet dans les projets au niveau du documentLimitations of the Worksheet Host Item in Document-Level Projects

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.You cannot create new Worksheet host items at run time in a document-level project. Si vous créez une feuille de calcul Excel au moment de l’exécution, elle sera de type Worksheet.If you create a new Excel worksheet at run time, it will be of the type Worksheet. Comme il ne s’agit pas d’un élément hôte, elle ne peut pas contenir de contrôles hôtes ni de contrôles Windows Forms.Because it is not a host item, it cannot contain any host controls or Windows Forms controls. Pour plus d’informations sur la création de documents au moment de l’exécution, consultez Comment : par programme ajouter des feuilles de calcul à des classeurs.For more information about creating documents at run time, see How to: Programmatically Add New Worksheets to Workbooks.

Présentation des éléments hôtes Worksheet dans les projets de complément VSTOUnderstanding Worksheet Host Items in VSTO Add-in projects

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.In application-level projects, you can generate a Worksheet host item at run time for any worksheet that is open in 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 .You can use the Worksheet host item to add controls to the associated worksheet, or to handle events that are not available on Worksheet objects.

Pour générer un Worksheet élément hôte, utilisez la méthode GetVstoObject.To generate a Worksheet host item, use the GetVstoObject method. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments VSTO au moment de l'exécution.For more information, see Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.

Voir aussiSee Also

Procédures pas à pas et des exemples de développement office Office Development Samples and Walkthroughs
Extension de Documents Word et classeurs Excel dans des Compléments VSTO au moment de l’exécution Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time
Contrôles sur des Documents Office Controls on Office Documents
Ajout de contrôles aux Documents Office au moment de l’exécution Adding Controls to Office Documents at Run Time
Vue d'ensemble des éléments hôtes et des contrôles hôtes Host Items and Host Controls Overview
Élément hôte de classeur Workbook Host Item
Automatisation d’Excel à l’aide d’objets étendus Automating Excel by Using Extended Objects
Limitations de programmation des éléments hôtes et des contrôles hôtesProgrammatic Limitations of Host Items and Host Controls