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 , MsDb2DataAdapterrecherche 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