Comment : mapper des colonnes d'une source de données à des colonnes d'une table de données d'un groupe de données

Article
08/21/2008

Mise à jour : novembre 2007

Le fait de créer un mappage dans un adaptateur de données vous permet d'établir une correspondance entre les colonnes de la source de données et une table d'un groupe de données. Pour plus d'informations, consultez Mappage des tables dans les adaptateurs de données.

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.

Pour mapper les colonnes d'une source de données avec une table d'un groupe de données

Créez un adaptateur de données. Pour plus d'informations, consultez Création d'adaptateurs de données.
Dans le Concepteur de formulaires ou de composants, sélectionnez l'adaptateur de données, puis ouvrez la fenêtre Propriétés.
En regard de la propriété TableMappings, cliquez sur le bouton Sélection (...). La boîte de dialogue Mappages de table s'ouvre.

Pour mapper des noms de colonnes de la source de données avec un groupe de données, activez la case à cocher Utiliser un groupe de données pour suggérer les noms de table et de colonne, puis sélectionnez un groupe de données dans la liste Dataset.

Les tables disponibles dans le groupe de données sont affichées dans la liste Table du groupe de données et les colonnes de la première table du groupe de données remplissent la partie droite de la grille Mappage de colonnes.

Remarque :
La sélection d'un groupe de données permet à la boîte de dialogue Mappages d'établir des valeurs par défaut pour les colonnes du groupe de données avec lesquelles le mappage doit être effectué. Le groupe de données ne fait pas partie des informations tenues à jour dans les mappages de l'adaptateur. En outre, vous pouvez utiliser les mêmes mappages avec plusieurs groupes de données.

Sous Table source, sélectionnez la table de la source de données à mapper. S'il n'y a qu'une seule table dans le groupe de données, la valeur par défaut est Table.
Sous Table du groupe de données, sélectionnez la table du groupe de données à mapper. Si vous avez sélectionné un groupe de données à mapper à l'étape 3, un nom sera déjà fourni. (Par défaut, la première table du groupe de données est appelée Table.)

En fonction de vos choix (ou des valeurs par défaut), les valeurs des listes Source Columns et Dataset Columns sont remplies. La grille indique comment le mappage sera effectué : chaque colonne de gauche est mise en correspondance avec la colonne de droite correspondante.
Ajustez les mappages en fonction de vos besoins. Vous pouvez notamment :
- Sélectionner différentes colonnes dans les listes de colonnes de la source ou dans celles du groupe de données pour modifier les mappages établis entre elles.
- Supprimer des colonnes du mappage. Vous supprimez des colonnes si l'adaptateur retourne plus de colonnes de la source de données que vous n'en avez besoin.
- Ajouter des colonnes. Vous ajoutez des colonnes si vous savez que des colonnes qui ne sont pas représentées au moment de la création existeront à celui de l'exécution, si vous avez supprimé une colonne et que vous souhaitez la récupérer ou encore si vous avez redéfini la requête de l'adaptateur et que vous devez maintenant ajuster les mappages en conséquence.
Lorsque vous avez fini d'ajuster les mappages, cliquez sur OK.

Si vous souhaitez spécifier la manière dont seront gérées les éventuelles conditions d'erreur, dans la fenêtre Propriétés, sélectionnez des options pour les propriétés MissingMappingAction et MissingSchemaAction. La table suivante répertorie les paramètres les plus courants et décrit leurs effets.

MissingMappingAction	MissingSchemaAction	Effet
Passthrough	Add ou AddWithKey	Si une colonne existe dans la source, mais pas dans le schéma, et qu'il n'existe pas de mappage pour elle, la colonne est créée lorsque le groupe de données est rempli. C'est le paramètre par défaut, et il est utile lorsque vous voulez simplement copier toutes les colonnes disponibles dans la source vers le groupe de données.
Ignore	Ignore	Si la colonne n'est pas définie dans le schéma du groupe de données ou s'il n'existe pas de mappage pour elle, les informations ne sont pas copiées de la source vers le groupe de données. Ce paramètre est utile si l'adaptateur retourne plus d'informations que vous n'en voulez dans le groupe de données.
Error	Error	Une erreur à l'exécution est déclenchée si l'adaptateur ne peut pas mapper une colonne de la source avec une colonne du groupe de données, parce que le mappage n'existe pas ou que le schéma du groupe de données ne contient pas de colonne. Ce paramètre est utile lorsque vous travaillez avec un schéma défini rigoureusement et que vous voulez être sûr que toutes les divergences par rapport à ce schéma seront signalées.