Configuration des mappages DataTable et DataColumn pour une base de données DB2
Un MsDb2DataAdapter
contient une collection de zéro ou plusieurs DataTableMapping
objets dans sa TableMappings
propriété. Un DataTableMapping
objet fournit un mappage master entre les données retournées par une requête sur une source de données et un DataTable
objet. Le DataTableMapping
nom peut être passé au lieu du DataTable
nom à la Fill
méthode du MsDb2DataAdapter
.
Un DataTableMapping
objet vous permet d’utiliser des noms de colonnes dans un DataTable
objet qui sont différents de ceux de la base de données. utilise MsDb2DataAdapter
le mappage pour faire correspondre les colonnes lorsque la table est mise à jour.
Si vous ne spécifiez pas de TableName
nom ou DataTableMapping
lors de l’appel de la Fill
méthode ou Update
de , MsDb2DataAdapter
recherche MsDb2DataAdapter
un DataTableMapping
nom nommé « Table ». Si cela n’existe DataTableMapping
pas, le TableName
de l’objet DataTable
est « Table ». Vous pouvez spécifier une valeur par défaut DataTableMapping
en créant un DataTableMapping
avec le nom « Table ».
Lorsque la Fill
méthode reçoit un instance d’un DataSet
et d’un DataTableMapping
nom, et si un mappage portant ce nom existe, elle est utilisée ; sinon, un DataTable
objet portant ce nom est utilisé.
Notes
Si un nom de colonne source n’est pas fourni pour un mappage de colonnes ou si un nom de table source n’est pas fourni pour un mappage de table, les noms par défaut sont générés automatiquement. Si aucune colonne source n'est fournie pour un mappage de colonne, celui-ci reçoit un nom incrémentiel par défaut de SourceColumnN, commençant par SourceColumn1. Si aucun nom de table source n'est fourni pour un mappage de table, celui-ci reçoit un nom incrémentiel par défaut de SourceTableN, commençant par SourceTable1.
Notes
Nous vous recommandons d’éviter la convention de nommage de SourceColumnN pour un mappage de colonnes, ou de SourceTableN pour un mappage de table, car le nom que vous fournissez peut entrer en conflit avec un nom de mappage de colonne par défaut existant dans ou ColumnMappingCollection
nom de mappage de table dans le DataTableMappingCollection
. Si le nom fourni existe déjà, une exception est levée.
Si SelectCommand
retourne plusieurs tables, Fill
génère automatiquement des noms de tables avec des valeurs incrémentielles pour les tables du jeu de données, en commençant par le nom de table spécifié et en continuant sous la forme TableNameN, en commençant par TableName1. Vous pouvez utiliser des mappages de tables pour mapper le nom de la table généré automatiquement à un nom que vous souhaitez spécifier pour la table dans le jeu de données.
Voir aussi
Utilisation de DataAdapter et de DataSet pour une base de données DB2
Utilisation du fournisseur managé pour DB2