Procédure pas à pas : récupération des données mises en cache d'un classeur sur un serveur

Cette procédure pas à pas montre comment récupérer des données d'un groupe de données mis en cache dans un classeur Microsoft Office Excel sans démarrer Excel à l'aide de la classe ServerDocument.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour Excel 2013 et Excel 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

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

• Définition d'un dataset qui contient des données de la base de données AdventureWorksLT.

• Création d'instances du groupe de données dans un projet de classeur Excel et un projet d'application console.

• Création d'un ListObject lié au groupe de données dans le classeur et remplissage du ListObject avec les données lorsque le classeur est ouvert.

• Ajout du groupe de données du classeur au cache de données.

• Lecture des données du groupe de données mis en cache dans le groupe de données de l'application console, sans démarrer Excel.

Bien que cette procédure pas à pas suppose que vous exécutiez le code sur votre ordinateur de développement, le code présenté par ce biais peut être mis en œuvre sur un serveur sur lequel Excel n'est pas installé.

[!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.Ces éléments dépendent de l'édition de Visual Studio dont vous disposez et des paramètres que vous utilisez.Pour plus d'informations, consultez Paramètres Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

-

Une édition de Visual Studio 2012 qui inclut les outils de développement Microsoft Office. Pour plus d'informations, consultez [Configuration d'un ordinateur pour développer des solutions Office](bb398242\(v=vs.110\).md).

• Excel 2013 ou Excel 2010.

• Accès à une instance en cours d'exécution de Microsoft SQL Server ou Microsoft SQL Server Express à laquelle l'exemple de base de données AdventureWorksLT est attaché.Vous pouvez télécharger la base de données AdventureWorksLT à partir du site Web CodePlex.Pour plus d'informations sur la façon d'attacher une base de données, consultez les rubriques suivantes :

  • Pour attacher une base de données en utilisant SQL Server Management Studio ou SQL Server Management Studio Express, consultez Procédure : attacher une base de données (SQL Server Management Studio).

  • Pour attacher une base de données en utilisant la ligne de commande, consultez Procédure : attacher un fichier de base de données à SQL Server Express.

Création d'un projet de bibliothèque de classes définissant un groupe de données

Pour utiliser le même groupe de données dans un projet de classeur Excel et une application console, vous devez définir le groupe de données dans un assembly séparé référencé par ces deux projets.Pour cette procédure pas à pas, définissez le groupe de données dans un projet de bibliothèque de classes.

Pour créer le projet Bibliothèque de classes

1. Démarrez Visual Studio.

2. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

3. Dans le volet des modèles, développez Visual C# ou Visual Basic, puis cliquez sur Fenêtres.

4. Dans la liste des modèles de projet, sélectionnez Bibliothèque de classes.

5. Dans la zone Nom, tapez AdventureWorksDataSet.

6. Cliquez sur Parcourir pour accéder au dossier %UserProfile%\Mes documents (Windows XP ou version antérieure) ou %UserProfile%\Documents (Windows Vista), puis cliquez sur Sélectionner un dossier.

7. Dans la boîte de dialogue Nouveau projet, vérifiez que la case à cocher Créer le répertoire pour la solution n'est pas activée.

8. Cliquez sur OK.

   Visual Studio ajoute le projet AdventureWorksDataSet à l'Explorateur de solutions et ouvre le fichier de code Class1.cs ou Class1.vb.

9. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Class1.cs ou Class1.vb, puis sélectionnez Supprimer.Vous n'avez pas besoin de ce fichier pour cette procédure pas à pas.

Définition d'un groupe de données dans le projet de bibliothèque de classes

Définissez un dataset typé qui contient des données de la base de données AdventureWorksLT pour SQL Server 2005.Plus tard au cours de cette procédure, vous ferez référence à ce dataset à partir d'un projet de classeur Excel et d'un projet d'application console.

Le groupe de données est un groupe de données typé qui représente les données de la table Product de la base de données AdventureWorksLT.Pour plus d'informations sur les groupes de données typés, consultez Utilisation de groupes de données dans Visual Studio.

Pour définir un groupe de données typé dans le projet de bibliothèque de classes

1. Dans l'Explorateur de solutions, cliquez sur le projet AdventureWorksDataSet.

2. Si la fenêtre Sources de données n'est pas visible, affichez- la par, dans la barre de menus, choisissant Afficher, Autres fenêtres, Sources de données.

3. Choisissez Ajouter une nouvelle source de données pour démarrer Assistant Configuration de source de données.

4. Cliquez sur Base de données, puis sur Suivant.

5. Si vous disposez d'une connexion active à la base de données AdventureWorksLT, choisissez cette connexion, puis cliquez sur Suivant.

   Dans le cas contraire, cliquez sur Nouvelle connexion, puis utilisez la boîte de dialogue Ajouter une connexion pour créer la nouvelle connexion.Pour plus d'informations, consultez Comment : établir une connexion à des données d'une base de données.

6. Sur la page Save the Connection String to the Application Configuration File, cliquez sur Next.

7. Sur la page Choisir vos objets de base de données, développez le nœud Tables, puis sélectionnez Product (SalesLT).

8. Cliquez sur Terminer.

   Le fichier AdventureWorksLTDataSet.xsd est ajouté au projet AdventureWorksDataSet.Ce fichier définit les éléments suivants :

   • un groupe de données typé nommé AdventureWorksLTDataSet.Ce groupe de données représente le contenu de la table Product dans la base de données AdventureWorksLT.

   • Un TableAdapter nommé ProductTableAdapter.Ce TableAdapter peut être utilisé pour lire et écrire des données dans AdventureWorksLTDataSet.Pour plus d'informations, consultez Vue d'ensemble de TableAdapter.

   Vous utiliserez ces deux objets plus loin dans cette procédure pas à pas.

9. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur AdventureWorksDataSet, puis sélectionnez Générer.

   Vérifiez que la génération du projet s'exécute correctement.

Création d'un projet de classeur Excel

Créez un projet de classeur Excel pour assurer l'interface vers les données.Plus loin dans cette procédure pas à pas, vous allez créer un objet ListObject qui affiche les données et vous allez ajouter une instance du groupe de données au cache de données dans le classeur.

Pour créer le projet de classeur Excel

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la solution AdventureWorksDataSet, pointez sur Ajouter, puis cliquez sur Nouveau projet.

2. Dans le volet modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.

3. Sous le nœud développé Office/SharePoint, sélectionnez le nœud Les compléments Office .

4. Dans la liste des modèles de projet, sélectionnez le projet de Classeur Excel 2010 ou de Classeur Excel 2013 .

5. Dans la zone Nom, tapez AdventureWorksReport.Ne modifiez pas l'emplacement.

6. Cliquez sur OK.

   L'Assistant Projet Visual Studio Tools pour Office s'ouvre.

7. Assurez-vous d'avoir sélectionné Créer un nouveau document, puis cliquez sur OK.

   Visual Studio ouvre le classeur AdventureWorksReport dans le concepteur et ajoute le projet AdventureWorksReport à l'Explorateur de solutions.

Ajout du groupe de données aux sources de données du projet de classeur Excel

Avant de pouvoir afficher le groupe de données dans le classeur Excel, vous devez l'ajouter aux sources de données du projet de classeur Excel.

Pour ajouter le groupe de données aux sources de données dans le projet de classeur Excel

1. Dans l'Explorateur de solutions, double-cliquez sur Sheet1.cs ou sur Sheet1.vb sous le projet AdventureWorksReport.

   Le classeur s'ouvre dans le concepteur.

2. Dans le menu Données, cliquez sur Ajouter une nouvelle source de données.

   L'Assistant Configuration de source de données s'ouvre.

3. Cliquez sur Objet, puis sur Suivant.

4. Sur la page Sélectionner l'objet que vous souhaitez lier, cliquez sur Ajouter une référence.

5. Sous l'onglet Projets, cliquez sur AdventureWorksDataSet puis cliquez sur OK.

6. Sous l'espace de noms AdventureWorksDataSet de l'assembly AdventureWorksDataSet, cliquez sur AdventureWorksLTDataSet, puis sur Terminer.

   La fenêtre Sources de données s'ouvre et AdventureWorksLTDataSet est ajouté à la liste des sources de données.

Création d'un ListObject lié à une instance du groupe de données

Pour afficher le groupe de données dans le classeur, créez un ListObject lié à une instance du groupe de données.Pour plus d'informations sur la liaison des contrôles aux données, consultez Liaison de données aux contrôles dans les solutions Office.

Pour créer un ListObject lié à une instance du groupe de données

1. Dans la fenêtre Sources de données, développez le nœud AdventureWorksLTDataSet, sous AdventureWorksDataSet.

2. Sélectionnez le nœud Product, cliquez sur la flèche de déroulement qui s'affiche et sélectionnez ListObject dans la liste déroulante.

   Si la flèche de déroulement ne s'affiche pas, assurez-vous que le classeur est ouvert dans le concepteur.

3. Faites glisser la table Product vers la cellule A1.

   Un contrôle ListObject nommé productListObject est créé dans la feuille de calcul, à partir de la cellule A1.Parallèlement, un objet DataSet nommé adventureWorksLTDataSet et un BindingSource nommé productBindingSource sont ajoutés au projet.ListObject est lié au BindingSource, qui est lui-même lié à l'objet de groupe de données.

Ajout du groupe de données au cache de données

Pour activer du code en dehors du projet de classeur Excel afin d'accéder au groupe de données du classeur, vous devez ajouter le groupe de données au cache de données.Pour plus d'informations sur le cache de données, consultez Données mises en cache dans des personnalisations au niveau du document et Mise en cache des données.

Pour ajouter le groupe de données au cache de données

1. Dans le concepteur, cliquez sur adventureWorksLTDataSet.

2. Dans la fenêtre Propriétés, affectez à la propriété Modifiers la valeur Public.

3. Affectez à la propriété CacheInDocument la valeur True.

Initialisation du groupe de données dans le classeur

Avant de pouvoir extraire les données du groupe de données mis en cache à l'aide de l'application console, vous devez commencer par le remplir de données.

Pour initialiser le groupe de données dans le classeur

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Sheet1.cs ou Sheet1.vb et sélectionnez Afficher le code.

2. Remplacez le gestionnaire d'événements Sheet1_Startup par le code suivant.Ce code utilise une instance de la classe ProductTableAdapter définie dans le projet AdventureWorksDataSet pour remplir de données le groupe de données mis en cache, s'il est actuellement vide.

   Private ProductTableAdapter As New  _
       AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter()
   
   Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       If Me.NeedsFill("AdventureWorksLTDataSet") Then
           Me.ProductTableAdapter.Fill(Me.AdventureWorksLTDataSet.Product)
       End If
   End Sub
   

   private AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter productTableAdapter =
       new AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter();
   
   private void Sheet1_Startup(object sender, System.EventArgs e)
   {
       if (this.NeedsFill("adventureWorksLTDataSet"))
       {
           this.productTableAdapter.Fill(this.adventureWorksLTDataSet.Product);
       }
   }
   

Point de contrôle

Générez et exécutez le projet de classeur Excel afin de garantir sa compilation et son exécution sans erreur.Cette opération remplit également le groupe de données mis en cache et enregistre les données dans le classeur.

Pour générer et exécuter le projet

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet AdventureWorksReport, sélectionnez Déboguer, puis Démarrer une nouvelle instance.

   Le projet est généré et le classeur s'ouvre dans Excel.Vérifiez les points suivants :

   • Le ListObject se remplit de données.

   • La valeur de la première ligne du ListObject dans la colonne ListPriceest 1431.5.À une étape ultérieure de cette procédure, vous utiliserez une application console pour modifier les valeurs de la colonne ListPrice.

2. Enregistrez le classeur.Ne modifiez pas le nom du fichier ni l'emplacement du classeur.

3. Fermez Excel.

Création d'un projet d'application console

Créez un projet d'application console à utiliser pour modifier des données dans le groupe de données mis en cache dans le classeur.

Pour créer le projet d'application console

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la solution AdventureWorksDataSet, pointez sur Ajouter, puis cliquez sur Nouveau projet.

2. Dans le volet Types de projets, développez Visual C# ou Visual Basic, puis cliquez sur Windows.

3. Dans le volet Modèles, sélectionnez Application console.

4. Dans la zone Nom, tapez DataReader.Ne modifiez pas l'emplacement.

5. Cliquez sur OK.

   Visual Studio ajoute le projet DataReader à l'Explorateur de solutions et ouvre le fichier de code Program.cs ou Module1.vb.

Récupération des données du groupe de données mis en cache à l'aide de l'application console

Utilisez la classe ServerDocument de l'application console pour lire les données dans un objet AdventureWorksLTDataSet local.Pour confirmer que le groupe de données local a été initialisé avec les données du groupe mis en cache, l'application affiche le nombre de lignes du groupe de données local.

Pour récupérer des données dans le groupe de données mis en cache

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet DataReader, puis sélectionnez Ajouter une référence.

2. Sous l'onglet de .NET, sélectionnez Microsoft.VisualStudio.Tools.Applications.ServerDocument.

3. Cliquez sur OK.

4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet DataReader, puis sélectionnez Ajouter une référence.

5. Sous l'onglet Projets, sélectionnez AdventureWorksDataSet, puis cliquez sur OK.

6. Ouvrez le fichier Program.cs ou Module1.vb dans l'éditeur de code.

7. Ajoutez l'instruction suivante using (pour C#) ou Imports (pour Visual Basic) au début du fichier de code.

   Imports Microsoft.VisualStudio.Tools.Applications
   

   using Microsoft.VisualStudio.Tools.Applications;
   

8. Ajoutez le code suivant à la méthode Main.Ce code déclare les objets suivants :

   • une instance du type AdventureWorksLTDataSet définie dans le projet AdventureWorksDataSet ;

   • Chemin du classeur AdventureWorksReport dans le dossier build du projet AdventureWorksReport

   • un objet ServerDocument à utiliser pour accéder au cache de données du classeur.

     [!REMARQUE]

     Le code suivant suppose que le classeur est enregistré avec l'extension .xlsx.Si le classeur de votre projet possède une autre extension, modifiez le chemin d'accès de la manière appropriée.

   Dim productDataSet As New AdventureWorksDataSet.AdventureWorksLTDataSet()
   Dim workbookPath As String = System.Environment.GetFolderPath( _
       Environment.SpecialFolder.MyDocuments) & _
       "\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx"
   Dim serverDocument1 As ServerDocument = Nothing
   

   AdventureWorksDataSet.AdventureWorksLTDataSet productDataSet =
       new AdventureWorksDataSet.AdventureWorksLTDataSet();
   string workbookPath = System.Environment.GetFolderPath(
       Environment.SpecialFolder.MyDocuments) +
       @"\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx";
   ServerDocument serverDocument1 = null;
   

9. Ajoutez le code suivant à la méthode Main après le code inséré à l'étape précédente.Ce code exécute les tâches suivantes :

   • Il utilise la propriété CachedData de la classe ServerDocument pour accéder au groupe de données mis en cache dans le classeur.

   • Il lit les données du groupe de données mis en cache dans le groupe de données local.

   • Il affiche le nombre de lignes du groupe de données local, afin de vérifier qu'il comporte des données.

   Try
       serverDocument1 = New ServerDocument(workbookPath)
       Dim dataHostItem1 As CachedDataHostItem = _
           serverDocument1.CachedData.HostItems("AdventureWorksReport.Sheet1")
       Dim dataItem1 As CachedDataItem = dataHostItem1.CachedData("AdventureWorksLTDataSet")
   
       If dataItem1 IsNot Nothing Then
           Console.WriteLine("Before reading data from the cache dataset, the local dataset has " & _
               "{0} rows.", productDataSet.Product.Rows.Count.ToString())
   
           ' Read the cached data from the worksheet dataset into the local dataset.
           Dim schemaReader As New System.IO.StringReader(dataItem1.Schema)
           Dim xmlReader As New System.IO.StringReader(dataItem1.Xml)
           productDataSet.ReadXmlSchema(schemaReader)
           productDataSet.ReadXml(xmlReader)
   
           Console.WriteLine("After reading data from the cache dataset, the local dataset has " & _
               "{0} rows.", productDataSet.Product.Rows.Count.ToString())
       Else
           Console.WriteLine("The data object is not found in the data cache.")
       End If
   Catch ex As System.IO.FileNotFoundException
       Console.WriteLine("The specified workbook does not exist.")
   Catch ex As System.Xml.XmlException
       Console.WriteLine("The data object has invalid XML information.")
   Finally
       If Not (serverDocument1 Is Nothing) Then
           serverDocument1.Close()
       End If
       Console.WriteLine(vbLf & vbLf & "Press Enter to close the application.")
       Console.ReadLine()
   End Try
   

   try
   {
       serverDocument1 = new ServerDocument(workbookPath);
       CachedDataHostItem dataHostItem1 =
           serverDocument1.CachedData.HostItems["AdventureWorksReport.Sheet1"];
       CachedDataItem dataItem1 = dataHostItem1.CachedData["adventureWorksLTDataSet"];
   
       if (dataItem1 != null)
       {
           Console.WriteLine("Before reading data from the cache dataset, the local dataset has " +
               "{0} rows.", productDataSet.Product.Rows.Count.ToString());
   
           // Read the cached data from the worksheet dataset into the local dataset.
           System.IO.StringReader schemaReader = new System.IO.StringReader(dataItem1.Schema);
           System.IO.StringReader xmlReader = new System.IO.StringReader(dataItem1.Xml);
           productDataSet.ReadXmlSchema(schemaReader);
           productDataSet.ReadXml(xmlReader);
   
           Console.WriteLine("After reading data from the cache dataset, the local dataset has " +
               "{0} rows.", productDataSet.Product.Rows.Count.ToString());
       }
       else
       {
           Console.WriteLine("The data object is not found in the data cache.");
       }
   }
   catch (System.IO.FileNotFoundException)
   {
       Console.WriteLine("The specified workbook does not exist.");
   }
   catch (System.Xml.XmlException)
   {
       Console.WriteLine("The data object has invalid XML information.");
   }
   finally
   {
       if (serverDocument1 != null)
       {
           serverDocument1.Close();
       }
   
       Console.WriteLine("\n\nPress Enter to close the application.");
       Console.ReadLine();
   }
   

10. Dans le menu Générer, cliquez sur Générer DataReader.

Test du projet

Lorsque vous exécutez l'application console, elle affiche le nombre de lignes du groupe de données local.

Pour tester le classeur

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet DataReader, pointez sur Déboguer, puis cliquez sur Démarrer une nouvelle instance.

   Vérifiez que l'application indique que le groupe de données local contient 295 lignes.

2. Appuyez sur ENTRÉE pour fermer l'application.

Étapes suivantes

Pour en savoir plus sur l'utilisation de données mises en cache, consultez les rubriques ci-dessous :

• Modification des données dans un groupe de données mis en cache sans démarrer Excel.Pour plus d'informations, consultez Procédure pas à pas : modification des données mises en cache dans un classeur sur un serveur.

Voir aussi

Tâches

Procédure pas à pas : insertion de données dans un classeur sur un serveur

Procédure pas à pas : modification des données mises en cache dans un classeur sur un serveur

Concepts

Connexion à des données dans des applications Windows Forms