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 DataTable objet en respectant DataTable constructeur.You can create a DataTable object by using the appropriate DataTable constructor. Vous pouvez l’ajouter à la DataSet à l’aide de la ajouter méthode à ajouter à la DataTable l’objet Tables collection.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 DataTable d’objets dans un DataSet à l’aide de la remplir ou FillSchema méthodes de la DataAdapter objet, ou à partir d’un prédéfini ou déduit XML schema à l’aide de la ReadXml, ReadXmlSchema, ou InferXmlSchema méthodes de la 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’après avoir ajouté un DataTable en tant que membre de la Tables collection d’un DataSet, vous ne pouvez pas l’ajouter à la collection de tables de n’importe quel 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.

Lorsque vous créez un DataTable, il ne possède pas de schéma (autrement dit, 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 sur le colonnes collection 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 contrainte des objets sur le contraintes collection 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. Une fois que vous avez défini le schéma pour un DataTable, vous pouvez ajouter des lignes de données à la table en ajoutant DataRow des objets sur le lignes collection 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 le TableName propriété lorsque vous créez un DataTable; vous pouvez spécifier la propriété à un autre moment, ou vous pouvez la laisser 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 un TableName valeur un DataSet, le tableau aura un nom incrémentiel par défaut de TableN, en 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 le « TableN« convention d’affectation de noms lorsque vous fournissez un TableName valeur, car le nom fourni peut entrer 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 DataTable objet 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 Tables collection 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