DataTableCollection Classe

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataTableCollection.cs

Représente la collection de tables de DataSet.

public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase

[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase

[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase

Héritage

Object

InternalDataCollectionBase

DataTableCollection

Attributs

ListBindableAttribute

Exemples

La première procédure de cet exemple récupère le DataTableCollection d’un DataSet et imprime la valeur de chaque colonne, dans chaque ligne, de chaque table. La deuxième procédure en crée un avec DataTable deux colonnes et l’ajoute à .DataTableCollection

private void GetTables(DataSet dataSet)
{
    // Get Each DataTable in the DataTableCollection and
    // print each row value.
    foreach (DataTable table in dataSet.Tables)
        foreach (DataRow row in table.Rows)
            foreach (DataColumn column in table.Columns)
                if (row[column] != null)
                    Console.WriteLine(row[column]);
}

private void CreateTable(DataSet dataSet)
{
    DataTable newTable = new DataTable("table");
    newTable.Columns.Add("ID", typeof(int));
    newTable.Columns.Add("Name", typeof(string));
    dataSet.Tables.Add(newTable);
}

Private Sub GetTables(dataSet As DataSet)
   ' Get Each DataTable in the DataTableCollection and 
   ' print each row value.
   Dim table As DataTable
   Dim row As DataRow
   Dim column As DataColumn
   For Each table In dataSet.Tables
      For Each row In table.Rows
         For Each column in table.Columns
            If Not (row(column) Is Nothing) Then
               Console.WriteLine(row(column))
            End If
         Next
      Next
   Next
End Sub

Private Sub CreateTable(dataSet As DataSet)
   Dim newTable As New DataTable("table")
   newTable.Columns.Add("ID", Type.GetType("System.Int32"))
   newTable.Columns.Add("Name", Type.GetType("System.String"))
   dataSet.Tables.Add(newTable)
End Sub

Remarques

contient DataTableCollection tous les DataTable objets d’un particulier DataSet. Pour accéder au DataTableCollection d’un DataSet, utilisez la Tables propriété .

Utilise DataTableCollection des méthodes telles que Add, Clearet Remove pour gérer les éléments de la collection.

Utilisez la Contains méthode pour déterminer si une table particulière (spécifiée par l’index ou le nom) se trouve dans la collection.

Pour naviguer d’une table à l’autre, utilisez la ChildRelations propriété ou ParentRelations du DataTable pour accéder à sa collection d’objets DataRelation . Vous pouvez également utiliser la Relations propriété pour parcourir les relations parent/enfant de dans DataTables une collection particulière DataSet .

Propriétés

Count	Obtient le nombre total d'éléments dans une collection. (Hérité de InternalDataCollectionBase)
IsReadOnly	Obtient une valeur qui indique si l’objet InternalDataCollectionBase est en lecture seule. (Hérité de InternalDataCollectionBase)
IsSynchronized	Obtient une valeur qui indique si l’objet InternalDataCollectionBase est synchronisé. (Hérité de InternalDataCollectionBase)
Item[Int32]	Obtient l’objet DataTable à l’index spécifié.
Item[String, String]	Obtient l'objet DataTable avec le nom spécifié dans l'espace de noms spécifié.
Item[String]	Obtient l'objet DataTable avec le nom spécifié.
List	Obtient les éléments de la collection sous la forme d'une liste. (Hérité de InternalDataCollectionBase)
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser la collection. (Hérité de InternalDataCollectionBase)

Méthodes

Add()	Crée un nouvel objet DataTable avec un nom par défaut et l'ajoute à la collection.
Add(DataTable)	Ajoute l'objet DataTable spécifié à la collection.
Add(String)	Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.
Add(String, String)	Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.
AddRange(DataTable[])	Copie les éléments du tableau DataTable spécifié à la fin de la collection.
CanRemove(DataTable)	Vérifie si l'objet DataTable spécifié peut être supprimé de la collection.
Clear()	Efface tous les objets DataTable de la collection.
Contains(String)	Obtient une valeur qui indique si un objet DataTable portant le nom spécifié existe dans la collection.
Contains(String, String)	Obtient une valeur qui indique si un objet DataTable portant le nom et l'espace de noms spécifié existe dans la collection.
CopyTo(Array, Int32)	Copie tous les éléments du InternalDataCollectionBase en cours dans un Array unidimensionnel, en commençant à l'index InternalDataCollectionBase spécifié. (Hérité de InternalDataCollectionBase)
CopyTo(DataTable[], Int32)	Copie tous les éléments du DataTableCollection en cours dans un Array unidimensionnel, en commençant à l'index de tableau de destination spécifié.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Obtient un IEnumerator de la collection. (Hérité de InternalDataCollectionBase)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(DataTable)	Obtient l'index de l'objet DataTable spécifié.
IndexOf(String)	Obtient l'index de l'objet DataTable portant le nom spécifié dans la collection.
IndexOf(String, String)	Obtient l'index de l'objet DataTable spécifié dans la collection.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(DataTable)	Supprime l'objet DataTable spécifié de la collection.
Remove(String)	Supprime de la collection l’objet DataTable avec le nom spécifié.
Remove(String, String)	Supprime de la collection l’objet DataTable avec le nom spécifié.
RemoveAt(Int32)	Supprime l’objet DataTable de la collection, à l’index spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

CollectionChanged	Se produit une fois que DataTableCollection est modifié en raison de l'ajout ou de la suppression d'objets DataTable.
CollectionChanging	Se produit lorsque DataTableCollection est modifié en raison de l'ajout ou de la suppression d'objets DataTable.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser toutes les opérations d’écriture.

Voir aussi

• DataColumn
• DataRow
• DataTable
• DataSet