DataTableCollection DataTableCollection DataTableCollection DataTableCollection Class

Définition

Représente la collection de tables de DataSet.Represents the collection of tables for the DataSet.

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

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 toutes les lignes de chaque table.The first procedure in this example retrieves the DataTableCollection of a DataSet and prints the value of each column, in each row, of each table. La deuxième procédure crée un nouveau DataTable avec deux colonnes et l’ajoute à la DataTableCollection.The second procedure creates a new DataTable with two columns, and adds it to the 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 DataTable = 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

Le DataTableCollection contient tous les DataTable objets pour un particulier DataSet.The DataTableCollection contains all the DataTable objects for a particular DataSet. Pour accéder à la DataTableCollection d’un DataSet, utilisez le Tables propriété.To access the DataTableCollection of a DataSet, use the Tables property.

Le DataTableCollection utilise des méthodes telles que Add, Clear, et Remove pour gérer les éléments dans la collection.The DataTableCollection uses methods such as Add, Clear, and Remove to manage the items in the collection.

Utilisez le Contains méthode pour déterminer si une table particulière (spécifiée par index ou nom) est dans la collection.Use the Contains method to determine whether a particular table (specified by either index or name) is in the collection.

Pour accéder à partir d’une table à une autre, utilisez la ChildRelations ou ParentRelations propriété de la DataTable pour accéder à sa collection de DataRelation objets.To navigate from one table to another, use the ChildRelations or ParentRelations property of the DataTable to access its collection of DataRelation objects. Vous pouvez également utiliser le Relations propriété jusqu'à laquelle naviguer parmi les relations parent/enfant de la DataTables en un particulier DataSet collection.You can also use the Relations property to navigate through the parent/child relationships of the DataTables in a particular DataSet collection.

Propriétés

Count Count Count Count

Obtient le nombre total d'éléments dans une collection.Gets the total number of elements in a collection.

(Inherited from InternalDataCollectionBase)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtient une valeur qui indique si l'objet InternalDataCollectionBase est en lecture seule.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Inherited from InternalDataCollectionBase)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtient une valeur qui indique si l’objet InternalDataCollectionBase est synchronisé.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Inherited from InternalDataCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtient l’objet DataTable à l’index spécifié.Gets the DataTable object at the specified index.

Item[String, String] Item[String, String] Item[String, String] Item[String, String]

Obtient l'objet DataTable avec le nom spécifié dans l'espace de noms spécifié.Gets the DataTable object with the specified name in the specified namespace.

Item[String] Item[String] Item[String] Item[String]

Obtient l'objet DataTable portant le nom spécifié.Gets the DataTable object with the specified name.

List List List List

Obtient les éléments de la collection sous la forme d'une liste.Gets the items of the collection as a list.

(Inherited from InternalDataCollectionBase)
SyncRoot SyncRoot SyncRoot SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser la collection.Gets an object that can be used to synchronize the collection.

(Inherited from InternalDataCollectionBase)

Méthodes

Add() Add() Add() Add()

Crée un nouvel objet DataTable avec un nom par défaut et l'ajoute à la collection.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable) Add(DataTable) Add(DataTable) Add(DataTable)

Ajoute l'objet DataTable spécifié à la collection.Adds the specified DataTable to the collection.

Add(String) Add(String) Add(String) Add(String)

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.Creates a DataTable object by using the specified name and adds it to the collection.

AddRange(DataTable[]) AddRange(DataTable[]) AddRange(DataTable[]) AddRange(DataTable[])

Copie les éléments du tableau DataTable spécifié à la fin de la collection.Copies the elements of the specified DataTable array to the end of the collection.

CanRemove(DataTable) CanRemove(DataTable) CanRemove(DataTable) CanRemove(DataTable)

Vérifie si l'objet DataTable spécifié peut être supprimé de la collection.Verifies whether the specified DataTable object can be removed from the collection.

Clear() Clear() Clear() Clear()

Efface tous les objets DataTable de la collection.Clears the collection of all DataTable objects.

Contains(String) Contains(String) Contains(String) Contains(String)

Obtient une valeur qui indique si un objet DataTable portant le nom spécifié existe dans la collection.Gets a value that indicates whether a DataTable object with the specified name exists in the collection.

Contains(String, String) Contains(String, String) Contains(String, String) 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.Gets a value that indicates whether a DataTable object with the specified name and table namespace exists in the collection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copie tous les éléments du InternalDataCollectionBase en cours dans un Array unidimensionnel, en commençant à l'index InternalDataCollectionBase spécifié.Copies all the elements of the current InternalDataCollectionBase to a one-dimensional Array, starting at the specified InternalDataCollectionBase index.

(Inherited from InternalDataCollectionBase)
CopyTo(DataTable[], Int32) CopyTo(DataTable[], Int32) CopyTo(DataTable[], Int32) 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é.Copies all the elements of the current DataTableCollection to a one-dimensional Array, starting at the specified destination array index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Obtient un IEnumerator de la collection.Gets an IEnumerator for the collection.

(Inherited from InternalDataCollectionBase)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(DataTable) IndexOf(DataTable) IndexOf(DataTable) IndexOf(DataTable)

Obtient l'index de l'objet DataTable spécifié.Gets the index of the specified DataTable object.

IndexOf(String) IndexOf(String) IndexOf(String) IndexOf(String)

Obtient l'index de l'objet DataTable portant le nom spécifié dans la collection.Gets the index in the collection of the DataTable object with the specified name.

IndexOf(String, String) IndexOf(String, String) IndexOf(String, String) IndexOf(String, String)

Obtient l'index de l'objet DataTable spécifié dans la collection.Gets the index in the collection of the specified DataTable object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(DataTable) Remove(DataTable) Remove(DataTable) Remove(DataTable)

Supprime l'objet DataTable spécifié de la collection.Removes the specified DataTable object from the collection.

Remove(String) Remove(String) Remove(String) Remove(String)

Supprime de la collection l’objet DataTable avec le nom spécifié.Removes the DataTable object with the specified name from the collection.

Remove(String, String) Remove(String, String) Remove(String, String) Remove(String, String)

Supprime de la collection l’objet DataTable avec le nom spécifié.Removes the DataTable object with the specified name from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Supprime de la collection l'objet DataTable à l'index spécifié.Removes the DataTable object at the specified index from the collection.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements

CollectionChanged CollectionChanged CollectionChanged CollectionChanged

Se produit une fois que DataTableCollection est modifié en raison de l'ajout ou de la suppression d'objets DataTable.Occurs after the DataTableCollection is changed because of DataTable objects being added or removed.

CollectionChanging CollectionChanging CollectionChanging CollectionChanging

Se produit lorsque DataTableCollection est modifié en raison de l'ajout ou de la suppression d'objets DataTable.Occurs while the DataTableCollection is changing because of DataTable objects being added or removed.

Méthodes d’extension

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convertit un IEnumerable à un IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithreads.This type is safe for multithreaded read operations. Vous devez synchroniser des opérations d’écriture.You must synchronize any write operations.

Voir aussi