Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un DataTable, qui représente une table de données relationnelles en mémoire, peut être créé et utilisé indépendamment, ou peut être utilisé par d’autres objets .NET Framework, le plus souvent en tant que membre d’un DataSet.
Vous pouvez créer un DataTable objet à l’aide du constructeur approprié DataTable . Vous pouvez l’ajouter au DataSet en utilisant la méthode Add pour l’ajouter à la collection de l’objet DataSetTables.
Vous pouvez également créer DataTable objets au sein d’un DataSet en utilisant les méthodes Fill ou FillSchema de l’objet DataAdapter, ou à partir d’un schéma XML prédéfini ou déduit en utilisant les méthodes ReadXml, ReadXmlSchema ou InferXmlSchema du DataSet. Notez qu’une fois que vous avez ajouté un DataTable membre de la Tables collection d’un DataSet, vous ne pouvez pas l’ajouter à la collection de tables d’un autre DataSet.
Lorsque vous créez un DataTable pour la première fois, il n’a pas de schéma (autrement dit, une structure). Pour définir le schéma de la table, vous devez créer et ajouter des DataColumn objets à la Columns collection de la table. Vous pouvez également définir une colonne clé primaire pour la table et créer et ajouter des Constraint objets à la Constraints collection de la table. Une fois que vous avez défini le schéma d’un DataTable, vous pouvez ajouter des lignes de données à la table en ajoutant DataRow des objets à la Rows collection de la table.
Vous n’êtes pas obligé de fournir une valeur pour la 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. Toutefois, lorsque vous ajoutez une table sans TableName valeur à un DataSet, la table reçoit un nom par défaut incrémentiel de tableN, en commençant par « Table » pour Table0.
Remarque
Nous vous recommandons d’éviter la convention d’affectation de noms « TableN » lorsque vous fournissez une TableName valeur, car le nom que vous fournissez peut entrer en conflit avec un nom de table par défaut existant dans le DataSet. Si le nom fourni existe déjà, une exception est levée.
L’exemple suivant crée une instance d’un DataTable objet et lui attribue le nom « 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.
Dim customers As DataSet = New DataSet
Dim customersTable As DataTable = _
customers.Tables.Add("CustomersTable")
DataSet customers = new DataSet();
DataTable customersTable = customers.Tables.Add("CustomersTable");