Configuration d'adaptateur de données (Assistant)
L'Assistant Configuration d'adaptateur de données vous aide à définir les propriétés d'un adaptateur de données nouveau ou existant. Un adaptateur de données contient des commandes SQL, dont votre application peut se servir pour lire des données ou répercuter des changements dans la base de données en fonction des opérations effectuées sur le groupe de données. L'Assistant peut éventuellement créer une connexion de données permettant à l'adaptateur de communiquer avec une base de données.
La configuration d'un adaptateur de données est l'une des opérations à effectuer lorsque vous utilisez un groupe de données dans votre application. Après avoir exécuté l'Assistant, vous devrez encore ajouter séparément un groupe de données à votre application et écrire le code pour permettre à l'adaptateur de données de l'utiliser.
Notes
Dans la version antérieure de Visual Studio, des adaptateurs de données étaient utilisés pour la communication entre applications et bases de données. Même si les adaptateurs de données figurent toujours parmi les principaux composants des Fournisseurs de données .NET Framework (ADO.NET), les TableAdapters sont des composants générés par le concepteur qui simplifient le processus de manipulation des données entre votre application et une base de données. Pour plus d'informations sur l'utilisation de TableAdapters, consultez Vue d'ensemble de TableAdapter.
Exécution de l'Assistant
Vous pouvez exécuter l'Assistant pour créer de nouveaux adaptateurs ou modifier les adaptateurs existants. Vous pouvez également exécuter l'Assistant sur un adaptateur de données existant pour changer les propriétés de ce dernier.
Pour exécuter l'Assistant
Effectuez l'une des actions suivantes :
Si vous créez un nouvel adaptateur, faites glisser un objet adaptateur de données de la boîte à outils sur un formulaire ou un composant.
Si vous modifiez un adaptateur existant, sélectionnez-le dans le formulaire ou le composant, puis sélectionnez Configurer l'adaptateur de données dans le menu contextuel.
L'Assistant démarre.
Spécifiez les informations relatives à la connexion et aux commandes SQL. Pour vous faciliter la tâche, l'Assistant affiche plusieurs boîtes de dialogue :
Si vous demandez à créer une connexion, l'Assistant affiche l'onglet Connexion de la Ajouter/Modifier une connexion, boîte de dialogue (Général), qui vous permet de spécifier un fournisseur, un nom de serveur, un nom de base de données, un nom d'utilisateur et un mot de passe pour la connexion.
Pour vous aider à créer des instructions SQL, l'Assistant fournit le Générateur de requêtes, un utilitaire qui vous permet de créer et de tester une instruction Select à l'aide d'outils visuels. Pour le lancer, cliquez sur le bouton Générateur de requêtes lorsqu'une instruction SQL vous est demandée. Pour plus d'informations, consultez Outils du Concepteur de requêtes et de vues.
Conseil
Si vous spécifiez que vous voulez créer des procédures stockées, cliquez sur Afficher un aperçu du script SQL pour visualiser le script que l'Assistant utiliserait à cet effet. Vous pouvez copier ce script et le modifier pour créer vos propres procédures.
Notes
Si vous cliquez sur Annuler dans l'Assistant, l'adaptateur est créé, mais ses propriétés ne sont pas définies. Vous pouvez les définir manuellement dans la fenêtre Propriétés ou exécuter de nouveau l'Assistant.
Fonctionnement de l'Assistant
L' Assistant Configuration d'adaptateur de données vous guide tout au long de la procédure de création d'un adaptateur de données (et, si nécessaire, d'une connexion de données). L'Assistant effectue les opérations suivantes :
Il crée l'adaptateur.
Si nécessaire, il crée une connexion de données et configure l'adaptateur pour qu'il utilise la connexion.
Il crée l'instruction SQL ou les procédures stockées employées pour lire et écrire des données.
Il crée et configure des paramètres pour les instructions SQL ou les procédures stockées afin que les commandes lisent et écrivent les données correctes.
Il mappe les noms des tables et des colonnes entre la base de données et le groupe de données.
Configuration des objets Command
L'essentiel du travail de l'Assistant consiste à configurer les quatre objets de commande de données que l'adaptateur utilise pour passer les données à la base de données et à partir de cette dernière : l'objet SelectCommand et, éventuellement, les objets UpdateCommand, InsertCommand et DeleteCommand. Chacun de ces objets contient soit une instruction SQL soit le nom d'une procédure stockée utilisée pour lire et écrire des données. Les propriétés de chacune de ces commandes (notamment la propriété CommandText) sont définies en fonction des choix effectués dans l'Assistant.
L'Assistant vous permet d'utiliser des instructions SQL ou des procédures stockées pour les commandes. Il vous propose plusieurs options :
Utiliser des instructions SQL. Vous pouvez spécifier une instruction Select et, si vous choisissez de les créer, l'Assistant génère les instructions Update, Insert et Delete correspondantes en se basant sur les informations que vous avez incluses dans l'instruction Select. Les instructions Update et Insert incluent des paramètres pour passer les nouvelles valeurs. Les instructions Update, Insert et Delete incluent des paramètres dans une clause WHERE pour localiser l'enregistrement correct à l'intérieur de la base de données.
Créer de nouvelles procédures stockées. Cette option est similaire à la précédente, à la différence près que l'Assistant génère des procédures stockées, et non des instructions. Dans la mesure où les procédures stockées peuvent être plus rapides que les instructions SQL, vous pouvez choisir cette option pour des raisons liées aux performances. L'Assistant génère alors des procédures stockées pour les quatre commandes (en fonction, ici aussi, de ce que vous avez spécifié dans la commande Select). Vous pouvez choisir d'écrire les nouvelles procédures stockées dans votre base de données. Sinon, vous pouvez encore capturer le script SQL que l'Assistant utiliserait pour créer les procédures stockées, avec possibilité de l'exécuter vous-même ultérieurement.
Utiliser des procédures stockées existantes. Avec cette option, vous sélectionnez des procédures stockées pour chacune des quatre commandes. L'Assistant affiche les noms et les détails des procédures stockées qu'il trouve dans la base de données. Cette option est utile si vous avez déjà des procédures stockées qui exécutent les quatre opérations sur la base de données.
Options avancées de l'Assistant
L'Assistant propose des options avancées qui vous permettent de contrôler la création des commandes Update, Insert et Delete pour l'adaptateur de données. Vous pouvez afficher la boîte de dialogue Options de génération SQL avancées à partir du volet Générer des instructions SQL de l'Assistant en cliquant sur Options avancées.
Cette boîte de dialogue vous permet de spécifier les options suivantes :
Générer des instructions Insert, Update et Delete. Indique que l'adaptateur de données générera des instructions ou des procédures stockées supplémentaires, basées sur l'instruction Select, pour écrire des données dans la base de données. Si l'adaptateur de données doit être utilisé exclusivement pour l'écriture des données, et non pour leur mise à jour, vous pouvez éventuellement obtenir un code plus efficace en désactivant cette case à cocher.
Utiliser l'accès concurrentiel optimiste. Indique que l'Assistant doit inclure le code pour vérifier si un enregistrement a changé depuis que vous l'avez lu dans la base de données.
Actualiser le groupe de données. Indique si l'Assistant doit générer le code qui relit un enregistrement dans la base de données après l'avoir mis à jour. Cela vous permet d'obtenir une vue actualisée d'un enregistrement, avec les valeurs insérées par la base de données, telles les valeurs par défaut et incrémentées automatiquement.
Pour plus d'informations, consultez Options de génération SQL avancées, boîte de dialogue.
Étapes suivantes
Une fois l'exécution de l'Assistant terminée, l'adaptateur de données est ajouté à votre formulaire (avec, éventuellement, la connexion). Vous pouvez ensuite effectuer plusieurs opérations, dont certaines sont presque systématiques et d'autres facultatives.
Opérations qui peuvent s'avérer nécessaires
Les opérations suivantes sont celles que vous êtes souvent amené à effectuer lorsque l'exécution de l'Assistant Configuration d'adaptateur de données est terminée :
Ajouter d'autres adaptateurs de données. L'Assistant crée un adaptateur de données. Normalement, chaque adaptateur de données sert à lire et écrire des données dans une table de données unique. Si vous prévoyez d'utiliser un groupe de données qui contient plusieurs tables, vous voudrez probablement ajouter d'autres adaptateurs de données à votre formulaire ou composant. Chaque fois que vous ajoutez un adaptateur de données à partir de la boîte à outils, vous devez relancer l'Assistant pour configurer cet adaptateur de données particulier.
Changer les mappages de table d'un adaptateur. Par défaut, l'adaptateur suppose qu'il utilisera les mêmes noms pour lire et écrire dans les tables et les colonnes. Toutefois, vous pouvez vous servir de l'adaptateur pour lire à partir d'une base de données qui utilise un nom, dans un groupe de données qui utilise des noms différents. Ou vous pouvez lire plus de colonnes de la base de données que vous n'en avez besoin dans le groupe de données.
Ajouter une logique pour remplir le groupe de données. Pour remplir un groupe de données à l'aide de l'adaptateur de données, vous devez appeler la méthode Fill de l'adaptateur. Cette dernière exécute la commande dans l'objet SelectCommand de l'adaptateur et remplit le groupe de données avec les résultats. Pour plus d'informations, consultez Remplissage d'un DataSet à partir d'un DataAdapter (ADO.NET).
Voir aussi
Référence
Configuration de TableAdapter (Assistant)
Concepts
Liaison de contrôles à des données dans Visual Studio
Autres ressources
Vue d'ensemble d'applications de données dans Visual Studio
Connexion aux données dans Visual Studio
Préparation de votre application pour recevoir des données
Extraction de données dans votre application