Procédure pas à pas : lier des données à des contrôles dans un volet Actions Excel

Cette procédure pas à pas illustre la liaison de données aux contrôles dans un volet Actions dans Microsoft Bureau Excel. Les contrôles illustrent une relation Maître/Détail entre des tables dans une base de données SQL Server.

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

Cette procédure pas à pas décrit les tâches suivantes :

• Ajout de contrôles à une feuille de calcul.

• Création d’un contrôle du volet Actions.

• Ajout de contrôles Windows Forms liés aux données à un contrôle du volet Actions.

• Affichage du volet Actions lorsque l’application s’ouvre.

Remarque

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. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE Visual Studio.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

• Une édition de Visual Studio qui inclut les outils de développement Microsoft Office. Pour plus d’informations, consultez Configurer un ordinateur pour développer des solutions Bureau.

• Excel 2013 ou Excel 2010 .

• Accès à un serveur avec l’exemple de base de données Northwind SQL Server.

• Autorisations de lecture et d’écriture dans la base de données SQL Server.

Créer le projet

La première étape consiste à créer un projet de classeur Excel.

Pour créer un projet

1. Créez un projet de classeur Excel avec le nom Mon volet Actions Excel. Dans l’Assistant, sélectionnez Créer un document. Pour plus d’informations, consultez Guide pratique pour créer des projets Bureau dans Visual Studio.

   Visual Studio ouvre le nouveau classeur Excel dans le concepteur et ajoute le projet Mon volet Actions Excel à Explorateur de solutions.

Ajouter une nouvelle source de données au projet

Pour ajouter une nouvelle source de données au projet

1. Si la fenêtre Sources de données n’est pas visible, affichez-la dans la barre de menus, en choisissant Afficher>d’autres sources de données Windows>.

2. Choisissez Ajouter une nouvelle source de données pour démarrer l' Assistant Configuration de source de données.

3. Sélectionnez Base de données , puis cliquez sur Suivant.

4. Sélectionnez une connexion de données à l’exemple de base de données SQL Server Northwind ou ajoutez une nouvelle connexion à l’aide du bouton New Connecter ion.

5. Sélectionnez Suivant.

6. Désactivez l’option pour enregistrer la connexion si elle est sélectionnée, puis cliquez sur Suivant.

7. Développez le nœud Tables dans la fenêtre Objets de base de données.

8. Sélectionnez la zone case activée en regard de la table Fournisseurs.

9. Développez la table Products et sélectionnez ProductName, SupplierID, QuantityPerUnit et UnitPrice.

10. Cliquez sur Terminer.

    L’Assistant ajoute la table Fournisseurs et la table Products à la fenêtre Sources de données. Il ajoute également un jeu de données typé à votre projet qui est visible dans Explorateur de solutions.

Ajouter des contrôles à la feuille de calcul

Ensuite, ajoutez un NamedRange contrôle et un ListObject contrôle à la première feuille de calcul.

Pour ajouter un contrôle NamedRange et un contrôle ListObject

1. Vérifiez que le classeur My Excel Actions Pane.xlsx est ouvert dans le concepteur Visual Studio, avec Sheet1 l’affichage.

2. Dans la fenêtre Sources de données, développez la table Fournisseurs .

3. Cliquez sur la flèche déroulante sur le nœud Nom de la société, puis cliquez sur NamedRange.

4. Faites glisser le nom de la société de la fenêtre Sources de données vers la cellule A2 dans Sheet1.

   Un NamedRange contrôle nommé CompanyNameNamedRange est créé et le texte <CompanyName> apparaît dans la cellule A2. En même temps, un BindingSource adaptateur de table nommé suppliersBindingSourceet un DataSet est ajouté au projet. Le contrôle est lié au BindingSource, qui à son tour est lié à l’instance DataSet .

5. Dans la fenêtre Sources de données, faites défiler les colonnes situées sous la table Fournisseurs. En bas de la liste se trouve la table Products ; c’est ici parce qu’il s’agit d’un enfant de la table Fournisseurs . Sélectionnez cette table Products , et non celle qui se trouve au même niveau que la table Fournisseurs , puis cliquez sur la flèche déroulante qui s’affiche.

6. Cliquez sur ListObject dans la liste déroulante, puis faites glisser le tableau Products vers la cellule A6 dans Sheet1.

   Un ListObject contrôle nommé ProductNameListObject est créé dans la cellule A6. En même temps, un BindingSource adaptateur nommé productsBindingSource et une carte de table sont ajoutés au projet. Le contrôle est lié au BindingSource, qui à son tour est lié à l’instance DataSet .

7. Pour C# uniquement, sélectionnez fournisseursBindingSource dans la barre d’état des composants et remplacez la propriété Modificateurs par Interne dans la fenêtre Propriétés.

Ajouter des contrôles au volet Actions

Ensuite, vous avez besoin d’un contrôle du volet Actions qui a une zone de liste déroulante.

Pour ajouter un contrôle du volet Actions

1. Sélectionnez le projet Mon volet Actions Excel dans Explorateur de solutions.

2. Dans le menu Projet , cliquez sur Ajouter un nouvel élément.

3. Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez Contrôle du volet Actions, nommez-le ActionsControl, puis cliquez sur Ajouter.

Pour ajouter des contrôles Windows Forms liés aux données à un contrôle du volet Actions

1. Dans les onglets Contrôles communs de la boîte à outils, faites glisser un ComboBox contrôle vers le contrôle du volet Actions.

2. Remplacez la propriété Size par 171, 21.

3. Redimensionnez le contrôle utilisateur pour qu’il corresponde à la zone de liste modifiable.

Lier le contrôle dans le volet Actions aux données

Dans cette section, vous allez définir la source de données de la ComboBox même source de données que le NamedRange contrôle dans la feuille de calcul.

Pour définir les propriétés de liaison de données du contrôle

1. Cliquez avec le bouton droit sur le contrôle du volet Actions, puis cliquez sur Afficher le code.

2. Ajoutez le code suivant à l’événement Load du contrôle du volet Actions.

   C#

   private void ActionsControl_Load(object sender, EventArgs e)
   {
       this.comboBox1.DataSource = Globals.Sheet1.suppliersBindingSource;
       this.comboBox1.DisplayMember = "CompanyName";
   }
   

   VB

   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
   

3. En C#, vous devez créer un gestionnaire d’événements pour le ActionsControl. Vous pouvez placer ce code dans le ActionsControl constructeur. Pour plus d’informations sur la création de gestionnaires d’événements, consultez Guide pratique pour créer des gestionnaires d’événements dans Bureau projets.

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

Afficher le volet Actions

Le volet Actions n’est pas visible tant que vous n’avez pas ajouté le contrôle au moment de l’exécution.

Pour afficher le volet Actions

1. Dans Explorateur de solutions, cliquez avec le bouton droit sur ThisWorkbook.vb ou ThisWorkbook.cs, puis cliquez sur Afficher le code.

2. Créez une instance du contrôle utilisateur dans la ThisWorkbook classe.

   C#

   ActionsControl actions = new ActionsControl();
   

   VB

   Dim actions As New ActionsControl
   

3. Dans le Startup gestionnaire d’événements de ThisWorkbook, ajoutez le contrôle au volet Actions.

   C#

   private void ThisWorkbook_Startup(object sender, System.EventArgs e)
   {
       this.ActionsPane.Controls.Add(actions);
   }
   

   VB

   Private Sub ThisWorkbook_Startup(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Startup
   
       Me.ActionsPane.Controls.Add(actions)
   End Sub
   

Test de l’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.

Pour tester votre document

1. Appuyez sur F5 pour exécuter votre projet.

2. Vérifiez que le volet Actions est visible.

3. Sélectionnez une entreprise dans la zone de liste. Vérifiez que le nom de la 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.

4. Sélectionnez différentes entreprises pour vérifier que le nom de la société et les détails du produit changent selon les besoins.

Étapes suivantes

Voici quelques tâches susceptibles de venir après :

• Liaison de données à des contrôles dans Word. Pour plus d’informations, consultez Procédure pas à pas : Lier des données à des contrôles dans un volet Actions Word.

• Déploiement du projet. Pour plus d’informations, consultez Déployer une solution Bureau à l’aide de ClickOnce.

Contenu connexe

• Vue d’ensemble du volet Actions
• Guide pratique pour gérer la disposition du contrôle dans les volets Actions
• Lier des données à des contrôles dans des solutions Bureau