Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Remarque
La DataSet classe et les classes associées sont des technologies .NET Framework héritées du début des années 2000 qui permettent aux applications d’utiliser des données en mémoire pendant que les applications sont déconnectées de la base de données. Les technologies sont particulièrement utiles pour les applications qui permettent aux utilisateurs de modifier les données et de conserver les modifications apportées à la base de données. Bien que les jeux de données soient une technologie éprouvée, l’approche recommandée pour les nouvelles applications .NET consiste à utiliser Entity Framework Core. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet et dispose d’une interface de programmation plus simple.
Dans cette procédure pas à pas, vous allez créer un jeu de données à l’aide du Concepteur de jeux de données. L’article vous guide tout au long du processus de création d’un projet et l’ajout d’un nouvel élément DataSet à celui-ci. Vous allez apprendre à créer des tables basées sur des tables d’une base de données sans utiliser d’Assistant.
Conditions préalables
Pour suivre ce tutoriel, vous avez besoin de la charge de travail de développement .NET Desktop et (pour la fenêtre Sources de données ) du stockage et du traitement des données installés dans Visual Studio. Pour les installer, ouvrez visual Studio Installer et choisissez Modifier (ou Plus>Modifier) en regard de la version de Visual Studio que vous souhaitez modifier. Consultez Modifier Visual Studio.
Cette procédure pas à pas utilise SQL Server Express LocalDB et l’exemple de base de données Northwind.
Si sql Server Express LocalDB n’est pas installé, installez-le à partir de la page de téléchargement SQL Server Express ou via Visual Studio Installer. Dans visual Studio Installer, SQL Server Express LocalDB peut être installé dans le cadre de la charge de travail de stockage et de traitement des données , ou en tant que composant individuel.
Installez l’exemple de base de données Northwind en procédant comme suit :
Dans Visual Studio, ouvrez la fenêtre de l’Explorateur d’objets SQL Server. (L’Explorateur d’objets SQL Server est installé dans le cadre de la charge de travail de stockage et de traitement des données dans Visual Studio Installer.) Développez le nœud SQL Server . Cliquez avec le bouton droit sur votre instance LocalDB, puis sélectionnez nouvelle requête.
Une fenêtre de l’éditeur de requête s’ouvre.
Copiez le script Northwind Transact-SQL dans votre presse-papiers. Ce script T-SQL crée la base de données Northwind à partir de zéro et la remplit avec des données.
Collez le script T-SQL dans l’éditeur de requête, puis choisissez le bouton Exécuter.
Après un court laps de temps, l'exécution de la requête se termine et la base de données Northwind est créée.
Créer un projet d’application Windows Forms
Dans Visual Studio, créez un projet d’application Windows Forms (.NET Framework) et nommez-le DatasetDesignerWalkthrough.
Visual Studio ajoute le projet à l’Explorateur de solutions et affiche un nouveau formulaire dans le concepteur.
Ajouter un nouveau jeu de données à l’application
Dans le menu Projet , sélectionnez Ajouter un nouvel élément.
La boîte de dialogue Ajouter un nouvel élément s’affiche.
Dans le volet gauche, sélectionnez Données, puis Sélectionnez DataSet dans le volet central.
Nommez le jeu de données NorthwindDataset, puis choisissez Ajouter.
Visual Studio ajoute un fichier appelé NorthwindDataset.xsd au projet et l’ouvre dans le Concepteur de jeux de données.
Créer une connexion de données dans l’Explorateur de serveurs
Dans le menu Affichage , cliquez sur Explorateur de serveurs.
Dans l’Explorateur de serveurs, cliquez sur le bouton Se connecter à la base de données .
Créez une connexion à la base de données d’exemple Northwind.
Créer les tables dans le jeu de données
Cette section explique comment ajouter des tables au jeu de données.
Pour créer la table Clients
Développez la connexion de données que vous avez créée dans l’Explorateur de serveurs, puis développez le nœud Tables .
Faites glisser la table Customers de l’Explorateur de serveurs vers le Concepteur de jeux de données.
Une table de données Customers et CustomersTableAdapter sont ajoutées au jeu de données.
Pour créer la table Commandes
Faites glisser la table Orders de l’Explorateur de serveurs vers le Concepteur de jeux de données.
Une table de données Orders , OrdersTableAdapter et la relation de données entre les tables Customers et Orders sont ajoutées au jeu de données.
Pour créer la table OrderDetails
Faites glisser la table Order Details de l’Explorateur de serveurs vers le Concepteur de jeux de données.
Une table de données Order Details , OrderDetailsTableAdapter et une relation de données entre les tables Orders et OrderDetails sont ajoutées au jeu de données.
Enregistrer le jeu de données
Le jeu de données que vous venez de créer est disponible dans la fenêtre sources de données. Si vous ne voyez pas la fenêtre Sources de données , vérifiez que la charge de travail de stockage et de traitement des données est installée comme indiqué dans les conditions préalables.
Vous pouvez maintenant effectuer l’une des tâches suivantes :
Enregistrez le jeu de données.
Sélectionnez des éléments dans la fenêtre Sources de données et faites-les glisser sur un formulaire. Pour plus d’informations, consultez Lier des contrôles Windows Forms aux données dans Visual Studio.
Ajoutez d’autres requêtes aux TableAdapters.
Ajoutez la logique de validation aux événements ColumnChanging ou RowChanging des tables de données du jeu de données. Pour plus d’informations, consultez Valider les données dans les jeux de données.