Procédure pas à pas : Création d’une Relation de détail principale à l’aide d’un Dataset mis en cacheWalkthrough: Creating a Master Detail Relation Using a Cached Dataset

Cette procédure pas à pas illustre la création d’une relation maître/détail sur une feuille de calcul et de mise en cache les données afin que la solution puisse être utilisée en mode hors connexion.This walkthrough demonstrates creating a master/detail relation on a worksheet, and caching the data so that the solution can be used offline.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document 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.

Pendant cette procédure pas à pas, vous allez apprendre à :During this walkthrough, you will learn how to:

  • Ajouter des contrôles à une feuille de calcul.Add controls to a worksheet.

  • Définir un jeu de données mises en cache dans une feuille de calcul.Set up a dataset to be cached in a worksheet.

  • Ajoutez du code pour activer le défilement des enregistrements.Add code to enable scrolling through the records.

  • Votre projet de test.Test your project.

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 configuration d’un ordinateur pour développer des Solutions Office.For more information, see Configuring a Computer to Develop Office Solutions.

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

  • Accès à la base de données Northwind SQL Server.Access to the Northwind SQL Server sample database. La base de données peut être sur votre ordinateur de développement ou sur un serveur.The database can be on your development computer or on a server.

  • 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éation d'un projetCreating a New Project

Dans cette étape, vous allez créer un projet de classeur Excel.In this step, you will 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 maître / détail mon, à l’aide de Visual Basic ou c#.Create an Excel Workbook project with the name My Master-Detail, using either Visual Basic or C#. Assurez-vous que créer un nouveau document est sélectionnée.Make sure that Create a new document is selected. Pour plus d'informations, consultez How to: Create Office Projects in 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 maître / détail Mes projet l’Explorateur de solutions.Visual Studio opens the new Excel workbook in the designer and adds the My Master-Detail project to Solution Explorer.

Création de la source de donnéesCreating the Data Source

Utilisez la fenêtre Sources de données pour ajouter un dataset typé à votre projet.Use the Data Sources window to add a typed dataset to your project.

Pour créer la source de donnéesTo create the data source

  1. Si la fenêtre Sources de données n'est pas visible, affichez-la en choisissant, dans la barre de menus, Affichage, Autres fenêtres, Sources de données.If the Data Sources window is not 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. Après avoir sélectionné ou créé une connexion, cliquez sur suivant.After selecting or creating a connection, click Next.

  6. Désactivez l’option pour enregistrer la connexion si elle est activée, puis cliquez sur suivant.Clear the option to save the connection if it is 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 le commandes table et la Order Details table.Select the Orders table and the Order Details table.

  9. Cliquez sur Terminer.Click Finish.

    L’Assistant ajoute les deux tables à la des Sources de données fenêtre.The wizard adds the two tables 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.

Ajout de contrôles à la feuille de calculAdding Controls to the Worksheet

Dans cette étape, vous allez ajouter une plage nommée, un objet de liste et deux boutons à la première feuille de calcul.In this step, you will add a named range, a list object, and two buttons to the first worksheet. Ajoutez d’abord la plage nommée et l’objet de liste à partir de la des Sources de données fenêtre afin qu’ils sont automatiquement liés à la source de données.First, add the named range and the list object from the Data Sources window so that they are automatically bound to the data source. Ensuite, ajoutez les boutons de la boîte à outils.Next, add the buttons from the Toolbox.

Pour ajouter une plage nommée et un objet de listeTo add a named range and a list object

  1. Vérifiez que le My Master-Detail.xlsx classeur est ouvert dans le concepteur Visual Studio, avec Feuil1 affiché.Verify that the My Master-Detail.xlsx workbook is open in the Visual Studio designer, with Sheet1 displayed.

  2. Ouvrez le des Sources de données fenêtre et développez le commandes nœud.Open the Data Sources window and expand the Orders node.

  3. Sélectionnez le OrderID colonne, puis cliquez sur la flèche déroulante qui s’affiche.Select the OrderID column, and then click the drop-down arrow that appears.

  4. Cliquez sur NamedRange dans la liste déroulante, puis faites glisser le OrderID colonne à la cellule A2.Click NamedRange in the drop-down list, and then drag the OrderID column to cell A2.

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

  5. Faites défiler les colonnes qui sont sous la commandes table.Scroll down past the columns that are under the Orders table. Au bas de la liste est la Order Details table ; il est ici car il est un enfant de la commandes table.At the bottom of the list is the Order Details table; it is here because it is a child of the Orders table. Sélectionnez cette option Order Details table, pas celui qui se trouve au même niveau que le commandes de table, puis cliquez sur la flèche déroulante qui s’affiche.Select this Order Details table, not the one that is at the same level as the Orders table, and then click the drop-down arrow that appears.

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

  7. A ListObject contrôle nommé Order_DetailsListObject est créé dans la cellule A6et lié à la BindingSource.A ListObject control named Order_DetailsListObject is created in cell A6, and bound to the BindingSource.

Pour ajouter deux boutonsTo add two buttons

  1. À partir de la contrôles communs onglet de la boîte à outils, ajouter un Button contrôle cellule A3 de la feuille de calcul.From the Common Controls tab of the Toolbox, add a Button control to cell A3 of the worksheet.

    Ce bouton est nommé Button1.This button is named Button1.

  2. Ajoutez un autre Button contrôle cellule B3 de la feuille de calcul.Add another Button control to cell B3 of the worksheet.

    Ce bouton est nommé Button2.This button is named Button2.

    Ensuite, sélectionnez le jeu de données doit être mis en cache dans le document.Next, mark the dataset to be cached in the document.

La mise en cache le jeu de donnéesCaching the Dataset

Marquer le jeu de données mises en cache dans le document en rendant le jeu de données publics et paramètre les CacheInDocument propriété.Mark the dataset to be cached in the document by making the dataset public and setting the CacheInDocument property.

Pour mettre en cache le jeu de donnéesTo cache the dataset

  1. Sélectionnez NorthwindDataSet dans la barre d’état du composant.Select NorthwindDataSet in the component tray.

  2. Dans le propriétés fenêtre, de modifier le modificateurs propriété Public.In the Properties window, change the Modifiers property to Public.

    Jeux de données doit être publics avant la mise en cache est activée.Datasets must be public before caching is enabled.

  3. Modifier la CacheInDocument propriété True.Change the CacheInDocument property to True.

    L’étape suivante consiste à ajouter du texte aux boutons et en c#, ajoutez le code pour raccorder les gestionnaires d’événements.The next step is to add text to the buttons, and in C# add code to hook up the event handlers.

Initialisation des contrôlesInitializing the Controls

Définir le texte du bouton et ajoutez des gestionnaires d’événements pendant la Startup événement.Set the button text and add event handlers during the Startup event.

Pour initialiser les données et les contrôlesTo initialize the data and the controls

  1. Dans l’Explorateur de solutions, avec le bouton droit Sheet1.vb ou Sheet1.cs, puis cliquez sur afficher le Code dans le menu contextuel.In Solution Explorer, right-click Sheet1.vb or Sheet1.cs, and then click View Code on the shortcut menu.

  2. Ajoutez le code suivant à la Sheet1_Startup pour définir le texte des boutons.Add the following code to the Sheet1_Startup method to set the text for the buttons.

    Me.Button1.Text = "<"
    Me.Button2.Text = ">"
    
    this.button1.Text = "<";
    this.button2.Text = ">";
    
  3. Pour c# uniquement, ajouter des gestionnaires d’événements pour le bouton événements click à la Sheet1_Startup (méthode).For C# only, add event handlers for the button click events to the Sheet1_Startup method.

    this.button1.Click += new EventHandler(button1_Click);
    this.button2.Click += new EventHandler(button2_Click);
    

Ajout de Code pour activer le défilement des enregistrementsAdding Code to Enable Scrolling Through the Records

Ajoutez le code pour le Click Gestionnaire d’événements de chaque bouton pour parcourir les enregistrements.Add code to the Click event handler of each button to move through the records.

Pour faire défiler les enregistrementsTo scroll through the records

  1. Ajouter un gestionnaire d’événements pour le Click l’événement de Button1et ajoutez le code suivant pour vous déplacer vers l’arrière dans les enregistrements :Add an event handler for the Click event of Button1, and add the following code to move backwards through the records:

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
        Handles Button1.Click
    
        Me.OrdersBindingSource.MovePrevious()
    End Sub
    
    private void button1_Click(object sender, EventArgs e)
    {
        this.ordersBindingSource.MovePrevious();
    }
    
  2. Ajouter un gestionnaire d’événements pour le Click l’événement de Button2et ajoutez le code suivant pour faire défiler les enregistrements :Add an event handler for the Click event of Button2, and add the following code to advance through the records:

    Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
        Handles Button2.Click
    
        Me.OrdersBindingSource.MoveNext()
    End Sub
    
    private void button2_Click(object sender, EventArgs e)
    {
        this.ordersBindingSource.MoveNext();
    }
    

Test de l'applicationTesting the Application

Vous pouvez maintenant tester votre classeur pour vous assurer que les données apparaissent comme prévu et que vous pouvez utiliser la solution hors connexion.Now you can test your workbook to make sure that the data appears as expected, and that you can use the solution offline.

Pour tester la mise en cache de donnéesTo test the data caching

  1. Appuyez sur F5.Press F5.

  2. Vérifiez que la plage nommée et l’objet de liste sont remplis avec des données à partir de la source de données.Verify that the named range and the list object are filled with data from the data source.

  3. Faites défiler quelques-uns des enregistrements en cliquant sur les boutons.Scroll through some of the records by clicking the buttons.

  4. Enregistrez le classeur, puis fermez le classeur et Visual Studio.Save the workbook, and then close the workbook and Visual Studio.

  5. Désactiver la connexion à la base de données.Disable the connection to the database. Déconnectez le câble réseau à partir de votre ordinateur si la base de données se trouve sur un serveur, ou arrêter le service SQL Server si la base de données se trouve sur votre ordinateur de développement.Unplug the network cable from your computer if the database is located on a server, or stop the SQL Server service if the database is on your development computer.

  6. Ouvrez Excel et ouvrez My Master-Detail.xlsx à partir du répertoire \bin (\My Master-Detail\bin en Visual Basic ou \My Master-Detail\bin\debug en c#).Open Excel, and then open My Master-Detail.xlsx from the \bin directory (\My Master-Detail\bin in Visual Basic or \My Master-Detail\bin\debug in C#).

  7. Faire défiler des enregistrements pour vérifier que la feuille de calcul fonctionne normalement déconnecté.Scroll through some of the records to see that the worksheet operates normally when disconnected.

  8. Se reconnecter à la base de données.Reconnect to the database. Connectez votre ordinateur au réseau à nouveau si la base de données se trouve sur un serveur, ou démarrer le service SQL Server si la base de données se trouve sur votre ordinateur de développement.Connect your computer to the network again if the database is located on a server, or start the SQL Server service if the database is on your development computer.

Étapes suivantesNext Steps

Cette procédure pas à pas illustre les principes fondamentaux de la création d’une relation de données maître/détail sur une feuille de calcul et de mise en cache d’un jeu de données.This walkthrough shows the basics of creating a master/detail data relationship on a worksheet and caching a dataset. Voici quelques tâches susceptibles de venir après :Here are some tasks that might come next:

Voir aussiSee Also

Liaison de données aux contrôles dans les Solutions Office Binding Data to Controls in Office Solutions
Données dans les Solutions Office Data in Office Solutions
Mise en cache de données Caching Data
Vue d’ensemble des éléments hôtes et des contrôles hôtesHost Items and Host Controls Overview