Comment : ajouter des contrôles ListObject aux feuilles de calculHow to: Add ListObject controls to worksheets

Vous pouvez ajouter ListObject contrôles à une feuille de calcul Microsoft Office Excel au moment du design et au moment de l’exécution dans les projets au niveau du document.You can add ListObject controls to a Microsoft Office Excel worksheet at design time and at runtime in document-level projects.

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets 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.

Vous pouvez également ajouter ListObject contrôles lors de l’exécution dans les projets de complément VSTO.You can also add ListObject controls at runtime in VSTO Add-in projects.

Cette rubrique décrit les tâches suivantes :This topic describes the following tasks:

Ajouter des contrôles ListObject au moment du designAdd ListObject controls at design time

Il existe plusieurs manières d’ajouter des contrôles ListObject à une feuille de calcul Excel dans un projet au niveau du document au moment du design : dans Excel, à partir de la Boîte à outilsVisual Studio, et à partir de la fenêtre Sources de données .There are several ways to add ListObject controls to a worksheet in a document-level project at design time: From within Excel, from the Visual Studio Toolbox, and from the Data Sources window.

> [!NOTE] > Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use determine these elements. Pour plus d’informations, consultez personnaliser l’IDE.For more information, see Personalize the IDE.

Pour utiliser le ruban dans ExcelTo use the Ribbon in Excel

  1. Sous l’onglet Insérer du groupe Tableaux , cliquez sur Tableau.On the Insert tab, in the Tables group, click Table.

  2. Sélectionnez la ou les cellules que vous souhaitez inclure dans la liste, puis cliquez sur OK.Select the cell or cells you want to include in the list and click OK.

Pour utiliser la Boîte à outilsTo use the Toolbox

  1. À partir de l’onglet Contrôles Excel de la boîte à outils, faites glisser un ListObject sur la feuille de calcul.From the Excel Controls tab of the Toolbox, drag a ListObject to the worksheet.

    La boîte de dialogue Ajouter un contrôle ListObject s’affiche.The Add ListObject Control dialog box appears.

  2. Sélectionnez la ou les cellules que vous souhaitez inclure dans la liste, puis cliquez sur OK.Select the cell or cells you want to include in the list and click OK.

    Si vous ne souhaitez pas conserver le nom par défaut, vous pouvez le modifier dans la fenêtre Propriétés .If you do not want to keep the default name, you can change the name in the Properties window.

Pour utiliser la fenêtre Sources de donnéesTo use the Data Sources window

  1. Ouvrez la fenêtre Sources de données et créez une source de données pour votre projet.Open the Data Sources window and create a data source for your project. Pour plus d’informations, consultez ajouter de nouvelles connexions.For more information, see Add new connections.

  2. Faites glisser un tableau de la fenêtre Sources de données vers votre feuille de calcul.Drag a table from the Data Sources window to your worksheet.

    Un contrôle ListObject lié aux données est ajouté à la feuille de calcul.A data-bound ListObject control is added to the worksheet. Pour plus d’informations, consultez liaison de données et Windows Forms.For more information, see Data binding and Windows Forms.

Ajouter des contrôles ListObject au moment de l’exécution dans un projet au niveau du documentAdd ListObject controls at runtime in a document-level project

Vous pouvez ajouter la ListObject contrôle dynamiquement au moment de l’exécution.You can add the ListObject control dynamically at runtime. Cela vous permet de créer les contrôles hôtes en réponse à des événements.This enables you to create the host controls in response to events. Les objets de liste créés de manière dynamique ne sont pas persistants dans la feuille de calcul en tant que contrôles hôtes, une fois la feuille de calcul fermée.Dynamically created list objects are not persisted in the worksheet as host controls when the worksheet is closed. Pour plus d’informations, consultez ajouter des contrôles aux documents Office au moment de l’exécution.For more information, see Add controls to Office documents at runtime.

Pour ajouter par programmation un contrôle ListObject à une feuille de calculTo add a ListObject control to a worksheet programmatically

  1. Dans le gestionnaire d’événements Startup de Sheet1, insérez le code suivant pour ajouter un contrôle ListObject aux cellules A1 à A4.In the Startup event handler of Sheet1, insert the following code to add a ListObject control to cells A1 through A4.

    Microsoft.Office.Tools.Excel.ListObject employeeData;
    employeeData = this.Controls.AddListObject(this.get_Range("$A$1:$D$4"), "employees");
    
    Dim employeeData As Microsoft.Office.Tools.Excel.ListObject
    employeeData = Me.Controls.AddListObject(Me.Range("$A$1:$D$4"), "employees")
    

Ajouter des contrôles ListObject au moment de l’exécution dans un projet de complément VSTOAdd ListObject controls at runtime in a VSTO Add-in project

Vous pouvez ajouter par programmation un contrôle ListObject à une feuille de calcul ouverte dans un projet de complément VSTO.You can add a ListObject control programmatically to any open worksheet in a VSTO Add-in project. Les objets de liste créés de manière dynamique ne sont pas persistants dans la feuille de calcul en tant que contrôles hôtes, une fois la feuille de calcul enregistrée puis fermée.Dynamically created list objects are not persisted in the worksheet as host controls when the worksheet is saved and then closed. Pour plus d’informations, consultez documents Word d’étendre et classeurs Excel dans des Compléments VSTO lors de l’exécution.For more information, see Extend Word documents and Excel workbooks in VSTO Add-ins at runtime.

Pour ajouter par programmation un contrôle ListObject à une feuille de calculTo add a ListObject control to a worksheet programmatically

  1. Le code suivant génère un élément hôte de feuille de calcul basé sur la feuille de calcul ouverte, puis ajoute un contrôle ListObject aux cellules A1 à A4.The following code generates a worksheet host item that is based on the open worksheet, and then adds a ListObject control to cells A1 through A4.

    private void AddListObject()
    {
        Worksheet worksheet = Globals.Factory.GetVstoObject(
            Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);
    
        Microsoft.Office.Tools.Excel.ListObject list1;
        Excel.Range cell = worksheet.Range["$A$1:$D$4"];
        list1 = worksheet.Controls.AddListObject(cell, "list1");
    }
    
    Private Sub AddListObject()
        Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
            Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1)
    
        Dim worksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)
    
        Dim list1 As Microsoft.Office.Tools.Excel.ListObject
        Dim cell As Excel.Range = worksheet.Range("$A$1:$D$4")
        list1 = worksheet.Controls.AddListObject(cell, "MyListObject")
    End Sub
    

Voir aussiSee also

Étendre des documents Word et classeurs Excel dans des Compléments VSTO lors de l’exécution Extend Word documents and Excel workbooks in VSTO Add-ins at runtime
Contrôles sur des documents Office Controls on Office documents
ListObject (contrôle) ListObject control
Automatisation d’Excel à l’aide d’objets étendus Automate Excel by using extended objects
Éléments hôtes et vue d’ensemble des contrôles hôtes Host items and host controls overview
Comment : redimensionner les contrôles ListObject How to: Resize ListObject controls
Lier des données aux contrôles dans les solutions Office Bind data to controls in Office solutions
Limitations de programmation des éléments hôtes et des contrôles hôtesProgrammatic limitations of host items and host controls