Création d'un DataTableCreating a DataTable

Un objet DataTable, qui représente une table de données relationnelles en mémoire, peut être créé et utilisé de façon indépendante. Il peut également être utilisé par d'autres objets .NET Framework, la plupart du temps comme membre d'un objet DataSet.A DataTable, which represents one table of in-memory relational data, can be created and used independently, or can be used by other .NET Framework objects, most commonly as a member of a DataSet.

Vous pouvez créer un objet DataTable à l’aide du constructeur DataTable approprié.You can create a DataTable object by using the appropriate DataTable constructor. Vous pouvez l’ajouter au DataSet à l’aide de la méthode Add pour l’ajouter à la collection tables de l’objet DataTable .You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

Vous pouvez également créer des objets DataTable dans un DataSet à l’aide des méthodes Fill ou FillSchema de l’objet DataAdapter , ou à partir d’un schéma XML prédéfini ou inféré à l’aide de ReadXml, ReadXmlSchema , ou les méthodes InferXmlSchema du DataSet.You can also create DataTable objects within a DataSet by using the Fill or FillSchema methods of the DataAdapter object, or from a predefined or inferred XML schema using the ReadXml, ReadXmlSchema, or InferXmlSchema methods of the DataSet. Notez qu’une fois que vous avez ajouté un DataTable comme membre de la collection tables d’un DataSet, vous ne pouvez pas l’ajouter à la collection de tables d’un autre DataSet.Note that after you have added a DataTable as a member of the Tables collection of one DataSet, you cannot add it to the collection of tables of any other DataSet.

Quand vous créez un DataTablepour la première fois, il n’a pas de schéma (c’est-à-dire une structure).When you first create a DataTable, it does not have a schema (that is, a structure). Pour définir le schéma de la table, vous devez créer et ajouter DataColumn des objets à la collection Columns de la table.To define the schema of the table, you must create and add DataColumn objects to the Columns collection of the table. Vous pouvez également définir une colonne de clé primaire pour la table et créer et ajouter des objets de contrainte à la collection Constraints de la table.You can also define a primary key column for the table, and create and add Constraint objects to the Constraints collection of the table. Après avoir défini le schéma d’un DataTable, vous pouvez ajouter des lignes de données à la table en ajoutant des objets DataRow à la collection Rows de la table.After you have defined the schema for a DataTable, you can add rows of data to the table by adding DataRow objects to the Rows collection of the table.

Vous n’êtes pas obligé de fournir une valeur pour TableName la propriété lorsque vous créez un DataTable; vous pouvez spécifier la propriété à un autre moment, ou la conserver vide.You are not required to supply a value for the TableName property when you create a DataTable; you can specify the property at another time, or you can leave it empty. Toutefois, lorsque vous ajoutez une table sans valeur TableName à un jeu de données, la table reçoit un nom incrémentiel par défaut de tableN, commençant par « table » pour Table0.However, when you add a table without a TableName value to a DataSet, the table will be given an incremental default name of TableN, starting with "Table" for Table0.

Notes

Nous vous recommandons d’éviter la Convention d’affectation de noms « tableN» lorsque vous fournissez une valeur TableName , car le nom que vous fournissez peut être en conflit avec un nom de table par défaut existant dans le jeu de données.We recommend that you avoid the "TableN" naming convention when you supply a TableName value, because the name you supply may conflict with an existing default table name in the DataSet. Si le nom fourni existe déjà, une exception est levée.If the supplied name already exists, an exception is thrown.

L’exemple suivant crée une instance d’un objet DataTable et lui attribue le nom « Customers ».The following example creates an instance of a DataTable object and assigns it the name "Customers."

Dim workTable as DataTable = New DataTable("Customers")  
DataTable workTable = new DataTable("Customers");  

L’exemple suivant crée une instance d’un DataTable en l’ajoutant à la collection tables d’un DataSet.The following example creates an instance of a DataTable by adding it to the Tables collection of a DataSet.

Dim customers As DataSet = New DataSet  
Dim customersTable As DataTable = _  
   customers.Tables.Add("CustomersTable")  
DataSet customers = new DataSet();  
DataTable customersTable = customers.Tables.Add("CustomersTable");  

Voir aussiSee also