Comment : créer et configurer des adaptateurs de données manuellement

Article
08/21/2008

Mise à jour : novembre 2007

Vous pouvez créer des adaptateurs de données sans utiliser d'Assistant. Quelle que soit la manière dont vous avez créé l'adaptateur, vous pouvez toujours modifier sa configuration.

Remarque :
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 déplacement 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.

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 déplacement 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.

Remarque :
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Dans Visual Studio, la prise en charge des adaptateurs de données au moment du design est désactivée par défaut. Pour activer la prise en charge des adaptateurs de données, vous devez les ajouter à la Boîte à outils, comme décrit dans la première procédure ci-dessous.

Pour ajouter des adaptateurs de données, des connexions et des commandes à la Boîte à outils

Cliquez avec le bouton droit sur la Boîte à outils et choisissez Choisir les éléments.
Sélectionnez dans l'onglet Composants .NET Framework de la boîte de dialogue Choisir des éléments de boîte à outils les éléments que vous souhaitez ajouter. Par exemple, pour utiliser le Fournisseur de données .NET Framework pour SQL Server sélectionnez SqlDataAdapter, SqlConnection et SqlCommand.
Cliquez sur OK pour ajouter les éléments sélectionnés à la Boîte à outils.

Pour créer manuellement un adaptateur de données

Assurez-vous qu'un objet de connexion est disponible pour le formulaire ou le composant avec lequel vous travaillez. Pour plus d'informations sur l'ajout d'une connexion autonome, consultez Établissement de la connexion (ADO.NET).
Sous l'onglet Données de la Boîte à outils, faites glisser un objet OleDbDataAdapter, SqlDataAdapter, OdbcDataAdapter ou OracleDataAdapter sur l'aire de conception.

Le concepteur ajoute une instance de l'adaptateur au formulaire ou au composant et lance l'Assistant Configuration d'adaptateur de données.
Fermez l'Assistant.

Pour configurer manuellement un adaptateur de données

Sélectionnez l'adaptateur, puis configurez les commandes permettant de lire et de mettre à jour les données dans la fenêtre Propriétés. Vous devez configurer l'objet SelectCommand. Si l'adaptateur doit être utilisé pour mettre à jour une source de données, vous devez également configurer les objets UpdateCommand, DeleteCommand et InsertCommand.

Pour chaque objet de commande, définissez les propriétés suivantes.

Propriété	Description
ActiveConnection	Définissez une référence à un objet de connexion. Vous pouvez créer un objet de connexion à partir de la propriété ActiveConnection de la fenêtre Propriétés. En règle générale, chaque objet de commande référence le même objet de connexion, mais vous avez la possibilité d'utiliser des connexions différentes si votre application l'exige.
CommandText	Texte d'une instruction SQL ou nom d'une procédure stockée. Pour certains fournisseurs, vous pouvez inclure plusieurs noms d'instructions ou de procédures stockées dans la propriété CommandText en les séparant par des points-virgules (;). Les instructions ou procédures sont exécutées séquentiellement. Cela est utile, par exemple, lorsque vous émettez une instruction SELECT après une mise à jour ou une instruction INSERT pour récupérer des enregistrements actualisés et des valeurs générées automatiquement (valeurs par défaut ou incrémentées automatiquement).
CommandType	Valeur indiquant comment la valeur de la propriété CommandText doit être interprétée : Text - La commande est une instruction SQL. StoredProcedure - La commande est une référence à une procédure stockée. TableDirect - Le texte n'est pas une commande, mais le nom d'une table.
Parameters	Collection d'objets de type Parameter que vous configurez pour passer des valeurs à la commande. Dans l'objet SelectCommand, vous ne créez une collection de paramètres que si la commande inclut un espace réservé de paramètre. Les objets UpdateCommand, InsertCommand et DeleteCommand exigent toujours des paramètres. Pour plus d'informations, consultez Comment : configurer les paramètres pour des adaptateurs de données.

Si vous ne voulez pas obtenir les mêmes noms dans la source et dans le groupe de données, modifiez les mappages. La valeur par défaut de la propriété MissingMappingAction (Passthrough) génère automatiquement les mêmes noms dans la source et dans le groupe de données. Pour plus d'informations, consultez Comment : mapper des colonnes d'une source de données à des colonnes d'une table de données d'un groupe de données.
Dans le menu Données, cliquez sur Générer le groupe de données.

Conseil :

Si vous ne voyez pas le menu Données, cliquez n'importe où dans le Concepteur de formulaires ou de composants ; le menu n'apparaît que si le Concepteur a le focus.
Pour voir comment l'adaptateur remplira un groupe de données, affichez un aperçu des résultats. Pour plus d'informations, consultez Comment : afficher l'aperçu des résultats de l'adaptateur de données.

Conseil :
Si vous ne voyez pas le menu Données, cliquez n'importe où dans le Concepteur de formulaires ou de composants ; le menu n'apparaît que si le Concepteur a le focus.