DataTableCollection Classe

Définition

Représente la collection de tables de DataSet.

public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase
public ref class DataTableCollection : System::Data::InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public class DataTableCollection : System.Data.InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
    inherit InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type DataTableCollection = class
    inherit InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Public Class DataTableCollection
Inherits InternalDataCollectionBase
Héritage
DataTableCollection
Attributs

Exemples

La première procédure de cet exemple récupère la DataTableCollection valeur d’une DataSet colonne et imprime la valeur de chaque colonne, dans chaque ligne, de chaque table. La deuxième procédure crée une nouvelle DataTable colonne avec deux colonnes et l’ajoute au 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 à un DataTableCollection DataSetobjet , utilisez la Tables propriété.

Elle DataTableCollection utilise 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 ou la ChildRelations propriété de l’objet DataTable pour accéder à sa collection d’objetsDataRelation.ParentRelations Vous pouvez également utiliser la Relations propriété pour parcourir les relations parent/enfant d’une DataTables 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.

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)
OnCollectionChanged(CollectionChangeEventArgs)

Déclenche l’événement OnCollectionChanged(CollectionChangeEventArgs).

OnCollectionChanging(CollectionChangeEventArgs)
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.

S’applique à

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