Procédure pas à pas : Lier des données aux contrôles dans un volet actions ExcelWalkthrough: Bind data to controls on an Excel actions pane

Cette procédure pas à pas illustre la liaison de données aux contrôles dans un volet actions dans Microsoft Office Excel.This walkthrough demonstrates data binding to controls on an actions pane in Microsoft Office Excel. Les contrôles illustrent une relation Maître/Détail entre des tables dans une base de données SQL Server.The controls demonstrate a master/detail relation between tables in a SQL Server database.

S’applique à : Les informations contenues dans cette rubrique s’applique au document-niveau des projets pour Excel.Applies to: The information in this topic applies to document-level 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.

Cette procédure pas à pas décrit les tâches suivantes :This walkthrough illustrates the following tasks:

  • Ajout de contrôles à une feuille de calcul.Adding controls to a worksheet.

  • Création d’un contrôle de volet actions.Creating an actions pane control.

  • Ajout de contrôles de Windows Forms lié aux données à un contrôle de volet actions.Adding data-bound Windows Forms controls to an actions pane control.

  • Affichage du volet actions lorsque l’application s’ouvre.Showing the actions pane when the application opens.

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 Visual Studio.For more information, see Personalize the Visual Studio IDE.

PrérequisPrerequisites

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :You need the following components to complete this walkthrough:

  • Une édition de Visual Studio qui inclut les outils de développement Microsoft Office.An edition of Visual Studio that includes the Microsoft Office developer tools. Pour plus d’informations, consultez configurer un ordinateur pour développer des solutions Office.For more information, see Configure a computer to develop Office solutions.

  • Excel 2013Excel 2013 ou Excel 2010Excel 2010.or Excel 2010Excel 2010.

  • Accès à un serveur avec la base de données Northwind SQL Server.Access to a server with the Northwind SQL Server sample database.

  • Autorisations pour lire et écrire dans la base de données SQL Server.Permissions to read from and write to the SQL Server database.

Créer le projetCreate the project

La première étape consiste à créer un projet de classeur Excel.The first step is to create an Excel Workbook project.

Pour créer un projetTo create a new project

  1. Créer un projet de classeur Excel portant le nom Mon volet Actions Excel.Create an Excel Workbook project with the name My Excel Actions Pane. Dans l’Assistant, sélectionnez créer un nouveau document.In the wizard, select Create a new document. Pour plus d'informations, voir Procédure : Créer des projets Office dans Visual Studio.For more information, see How to: Create Office projects in Visual Studio.

    Visual Studio ouvre le nouveau classeur Excel dans le concepteur et ajoute le Mon volet Actions Excel projet l’Explorateur de solutions.Visual Studio opens the new Excel workbook in the designer and adds the My Excel Actions Pane project to Solution Explorer.

Ajouter une nouvelle source de données au projetAdd a new data source to the project

Pour ajouter une nouvelle source de données au projetTo add a new data source to the project

  1. Si le des Sources de données fenêtre n’est pas visible, affichez-la en, sur la barre de menus, choisissez vue > Windows autres > Sources de données.If the Data Sources window isn't visible, display it by, on the menu bar, choosing View > Other Windows > Data Sources.

  2. Choisissez Ajouter une nouvelle source de données pour démarrer l' Assistant Configuration de source de données.Choose Add New Data Source to start the Data Source Configuration Wizard.

  3. Sélectionnez base de données puis cliquez sur suivant.Select Database and then click Next.

  4. Sélectionnez une connexion de données à la base de données Northwind exemple SQL Server, ou ajouter une nouvelle connexion à l’aide de la nouvelle connexion bouton.Select a data connection to the Northwind sample SQL Server database, or add a new connection by using the New Connection button.

  5. Cliquez sur Suivant.Click Next.

  6. Désactivez l’option pour enregistrer la connexion si elle est sélectionnée, puis cliquez sur suivant.Clear the option to save the connection if it's selected, and then click Next.

  7. Développez le Tables nœud dans le objets de base de données fenêtre.Expand the Tables node in the Database objects window.

  8. Sélectionnez la case à cocher à côté du fournisseurs table.Select the check box next to the Suppliers table.

  9. Développez le produits de table et sélectionnez ProductName, SupplierID, QuantityPerUnit, et UnitPrice.Expand the Products table and select ProductName, SupplierID, QuantityPerUnit, and UnitPrice.

  10. Cliquez sur Terminer.Click Finish.

    L’Assistant ajoute les fournisseurs table et produits de la table vers le des Sources de données fenêtre.The wizard adds the Suppliers table and Products table to the Data Sources window. Il ajoute également un dataset typé à votre projet qui est visible dans l’Explorateur de solutions.It also adds a typed dataset to your project that is visible in Solution Explorer.

Ajouter des contrôles à la feuille de calculAdd controls to the worksheet

Ensuite, ajoutez un NamedRange contrôle et un ListObject contrôle pour la première feuille de calcul.Next, add a NamedRange control and a ListObject control to the first worksheet.

Pour ajouter un contrôle NamedRange et un contrôle ListObjectTo add a NamedRange control and a ListObject control

  1. Vérifiez que le Pane.xlsx d’Actions Excel Mes classeur est ouvert dans le concepteur Visual Studio, avec Sheet1 affiché.Verify that the My Excel Actions Pane.xlsx workbook is open in the Visual Studio designer, with Sheet1 displayed.

  2. Dans le des Sources de données fenêtre, développez le fournisseurs table.In the Data Sources window, expand the Suppliers table.

  3. Cliquez sur la flèche déroulante du nom de la société nœud, puis cliquez sur NamedRange.Click the drop-down arrow on the Company Name node, and then click NamedRange.

  4. Faites glisser nom de la société à partir de la des Sources de données fenêtre à cellule A2 dans Sheet1.Drag Company Name from the Data Sources window to cell A2 in Sheet1.

    Un NamedRange contrôle nommé CompanyNameNamedRange est créé et le texte <CompanyName > apparaît dans la cellule A2.A NamedRange control named CompanyNameNamedRange is created, and the text <CompanyName> appears in cell A2. En même temps, un BindingSource nommé suppliersBindingSource, un adaptateur de table et un DataSet sont ajoutés au projet.At the same time, a BindingSource named suppliersBindingSource, a table adapter, and a DataSet are added to the project. Le contrôle est lié à la BindingSource, qui est à son tour lié à la DataSet instance.The control is bound to the BindingSource, which in turn is bound to the DataSet instance.

  5. Dans le des Sources de données fenêtre, faites défiler vers le bas au-delà de colonnes qui sont sous la fournisseurs table.In the Data Sources window, scroll down past the columns that are under the Suppliers table. En bas de la liste est la produits table ; il est ici, car c’est un enfant de la fournisseurs table.At the bottom of the list is the Products table; it's here because it's a child of the Suppliers table. Sélectionnez cette option produits table, pas celui qui se trouve au même niveau que le fournisseurs de table, puis cliquez sur la flèche déroulante qui s’affiche.Select this Products table, not the one that is at the same level as the Suppliers table, and then click the drop-down arrow that appears.

  6. Cliquez sur ListObject dans la liste déroulante, puis faites glisser le produits table à cellule A6 dans Sheet1.Click ListObject in the drop-down list, and then drag the Products table to cell A6 in Sheet1.

    Un ListObject contrôle nommé ProductNameListObject est créé dans la cellule A6.A ListObject control named ProductNameListObject is created in cell A6. En même temps, un BindingSource nommé productsBindingSource et un adaptateur de table sont ajoutés au projet.At the same time, a BindingSource named productsBindingSource and a table adapter are added to the project. Le contrôle est lié à la BindingSource, qui est à son tour lié à la DataSet instance.The control is bound to the BindingSource, which in turn is bound to the DataSet instance.

  7. Pour C# uniquement, sélectionnez suppliersBindingSource sur la barre d’état du composant, puis remplacez le modificateurs propriété interne dans le propriétés fenêtre.For C# only, select suppliersBindingSource on the component tray, and change the Modifiers property to Internal in the Properties window.

Ajouter des contrôles au volet actionsAdd controls to the actions pane

Vous devez ensuite un contrôle de volet actions qui a une zone de liste déroulante.Next, you need an actions pane control that has a combo box.

Pour ajouter un contrôle de volet actionsTo add an actions pane control

  1. Sélectionnez le Mon volet Actions Excel projet l’Explorateur de solutions.Select the My Excel Actions Pane project in Solution Explorer.

  2. Dans le menu Projet , cliquez sur Ajouter un nouvel élément.On the Project menu, click Add New Item.

  3. Dans le ajouter un nouvel élément boîte de dialogue, sélectionnez contrôle de volet Actions, nommez-le ActionsControl, puis cliquez sur ajouter.In the Add New Item dialog box, select Actions Pane Control, name it ActionsControl, and click Add.

Pour ajouter des contrôles Windows Forms lié aux données à un contrôle de volet actionsTo add data-bound Windows Forms controls to an actions pane control

  1. À partir de la contrôles communs onglets de la boîte à outils, faites glisser un ComboBox vers le contrôle de volet actions.From the Common Controls tabs of the Toolbox, drag a ComboBox control to the actions pane control.

  2. Modifier le taille propriété 171, 21.Change the Size property to 171, 21.

  3. Redimensionner le contrôle utilisateur pour s’ajuster à la zone de liste déroulante.Resize the user control to fit the combo box.

Lier le contrôle dans le volet actions à des donnéesBind the control on the actions pane to data

Dans cette section, vous devez définir la source de données de la ComboBox à la même source de données en tant que le NamedRange contrôle sur la feuille de calcul.In this section, you'll set the data source of the ComboBox to the same data source as the NamedRange control on the worksheet.

Pour définir les propriétés de liaison de données du contrôleTo set data binding properties of the control

  1. Cliquez sur le contrôle de volet actions, puis cliquez sur afficher le Code.Right-click the actions pane control, and then click View Code.

  2. Ajoutez le code suivant à la Load événement du contrôle de volet actions.Add the following code to the Load event of the actions pane control.

    Private Sub ActionsControl_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
        Handles Me.Load
    
        Me.ComboBox1.DataSource = Globals.Sheet1.SuppliersBindingSource
        Me.ComboBox1.DisplayMember = "CompanyName"
    End Sub
    
    private void ActionsControl_Load(object sender, EventArgs e)
    {
        this.comboBox1.DataSource = Globals.Sheet1.suppliersBindingSource;
        this.comboBox1.DisplayMember = "CompanyName";
    }
    
  3. Dans C#, vous devez créer un gestionnaire d’événements pour le ActionsControl.In C#, you must create an event handler for the ActionsControl. Vous pouvez placer ce code dans le ActionsControl constructeur.You can place this code in the ActionsControl constructor. Pour plus d’informations sur la création de gestionnaires d’événements, consultez Comment : Créer des gestionnaires d’événements dans les projets Office.For more information about creating event handlers, see How to: Create event handlers in Office projects.

    public ActionsControl()
    {
        InitializeComponent();
        this.Load += new EventHandler(ActionsControl_Load);
    }
    

Afficher le volet actionsShow the actions pane

Le volet actions n’est pas visible jusqu'à ce que vous ajoutez le contrôle au runtime.The actions pane isn't visible until you add the control at runtime.

Pour afficher le volet actionsTo show the actions pane

  1. Dans l’Explorateur de solutions, avec le bouton droit ThisWorkbook.vb ou ThisWorkbook.cs, puis cliquez sur afficher le Code.In Solution Explorer, right-click ThisWorkbook.vb or ThisWorkbook.cs, and then click View Code.

  2. Créer une nouvelle instance du contrôle utilisateur dans le ThisWorkbook classe.Create a new instance of the user control in the ThisWorkbook class.

    ActionsControl actions = new ActionsControl();
    
    Dim actions As New ActionsControl
    
  3. Dans le Startup Gestionnaire d’événements de ThisWorkbook, ajoutez le contrôle au volet actions.In the Startup event handler of ThisWorkbook, add the control to the actions pane.

    private void ThisWorkbook_Startup(object sender, System.EventArgs e)
    {
        this.ActionsPane.Controls.Add(actions);
    }
    
    Private Sub ThisWorkbook_Startup(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Startup
    
        Me.ActionsPane.Controls.Add(actions)
    End Sub
    

Tester l’applicationTest the application

Vous pouvez maintenant tester votre document pour vérifier que le volet actions s’ouvre lorsque le document est ouvert et que les contrôles ont une relation maître/détail.Now you can test your document to verify that the actions pane opens when the document is opened, and that the controls have a master/detail relation.

Pour tester votre documentTo test your document

  1. Appuyez sur F5 pour exécuter votre projet.Press F5 to run your project.

  2. Vérifiez que le volet actions est visible.Confirm that the actions pane is visible.

  3. Sélectionnez une société dans la zone de liste.Select a company in the list box. Vérifiez que le nom de société est répertorié dans le NamedRange contrôle et que les détails du produit sont répertoriés dans le ListObject contrôle.Verify that the company name is listed in the NamedRange control and that the product details are listed in the ListObject control.

  4. Sélectionnez plusieurs sociétés pour vérifier le nom de l’entreprise et les détails du produit sont modifiés comme il convient.Select various companies to verify the company name and product details change as appropriate.

Étapes suivantesNext Steps

Voici quelques tâches susceptibles de venir après :Here are some tasks that might come next:

Voir aussiSee also