Tutoriel : Connexion aux DataSets ADO.NET
Introduction
Dans ce tutoriel, vous allez apprendre à connecter un rapport Crystal à un DataSet (groupe de données) ADO.NET à l'aide d'un schéma DataSet. Certaines étapes supplémentaires sont nécessaires pour créer un rapport à partir d'un DataSet ADO.NET, car le rapport n'est pas directement connecté à une base de données.
Un schéma DataSet ADO.NET fournit un modèle de structure de données au format XML. Cependant, un rapport ne peut pas extraire seul les données du schéma DataSet. Le schéma DataSet doit d'abord être instancié comme une instance DataSet fortement typée ou une instance DataSet générique. L'instance DataSet doit être ensuite remplie de données à l'aide de classes DataAdapter.
Dans ce tutoriel, étant donné la complexité de la création de rapports à partir de DataSets ADO.NET, les processus que vous allez suivre pour créer le schéma et remplir le DataSet sont isolés du code de liaison Crystal.
.gif) Remarque |
|---|
Crystal Reports pour Visual Studio propose un modèle intitulé DataSet pour créer un schéma DataSet ADO.NET. Dans les sites Web créés avec Visual Studio 2005 ou version ultérieure, le modèle DataSet n'est pas accessible à partir de la boîte de dialogue Ajouter un nouvel élément. Seul le modèle "Schéma XML" par défaut est disponible. Cependant, les légères modifications apportées au code (expliquées dans les étapes suivantes) permettent d'utiliser le modèle Schéma XML par défaut pour obtenir les mêmes résultats. |
Vous allez commencer par créer une connexion aux données et un schéma DataSet basé sur cette connexion. Vous créerez ensuite une classe d'assistance avec une propriété qui renvoie une instance remplie du DataSet. Enfin, vous écrirez du code qui lie le rapport Crystal au DataSet.
Pour le code de liaison du rapport Crystal, vous allez écrire du code pour effectuer les opérations suivantes :
- Instancier le rapport.
- Définir sa propriété SetDataSource en fonction de la propriété DataSet remplie à partir de la classe d'assistance.
- Lier le rapport Crystal rempli au contrôle CrystalReportViewer.
Enfin, si vous créez un site Web, vous allez placer l'instance DataSet remplie dans un objet Cache ASP.NET afin d'améliorer les performances et l'évolutivité.
Il est recommandé de dissocier le processus de configuration du DataSet du processus de liaison du rapport Crystal, afin de maintenir la clarté du code lorsque vous liez le rapport et de réutiliser le DataSet dans votre projet Web ou Windows.
Exemple de code
Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version terminée du projet. Suivez les instructions de ce tutoriel pour créer un projet ou ouvrez le projet d'exemple de code pour travailler à partir d'une version terminée.
Les exemples de code sont stockés dans des dossiers classés par langue et par type de projet. Les noms des dossiers de chaque version d'exemple de code sont les suivants :
- Site Web C# : CS_Web_Data_DataSets
- Projet Windows C# : CS_Win_Data_DataSets
- Site Web Visual Basic : VB_Web_Data_DataSets
- Projet Windows Visual Basic : VB_Win_Data_DataSets
Pour trouver les dossiers contenant ces exemples, voir Répertoire des exemples de code des tutoriels.