DataTableCollection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente la collection de tables pour le 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
- 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 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 à DataTableCollection un DataSet, utilisez la Tables propriété.
Il 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 à une 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
| Nom | Description |
|---|---|
| Count |
Obtient le nombre total d’éléments d’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 la InternalDataCollectionBase synchronisation est effectuée. (Hérité de InternalDataCollectionBase) |
| Item[Int32] |
Obtient l’objet DataTable à l’index spécifié. |
| Item[String, String] |
Obtient l’objet DataTable portant le nom spécifié dans l’espace de noms spécifié. |
| Item[String] |
Obtient l’objet DataTable portant le nom spécifié. |
| List |
Obtient les éléments de la collection sous forme de liste. |
| List |
Obtient les éléments de la collection sous forme de liste. (Hérité de InternalDataCollectionBase) |
| SyncRoot |
Obtient un objet qui peut être utilisé pour synchroniser la collection. (Hérité de InternalDataCollectionBase) |
Méthodes
| Nom | Description |
|---|---|
| Add() |
Crée un DataTable objet à l’aide d’un nom par défaut et l’ajoute à la collection. |
| Add(DataTable) |
Ajoute le paramètre spécifié |
| Add(String, String) |
Crée un DataTable objet à l’aide du nom spécifié et l’ajoute à la collection. |
| Add(String) |
Crée un DataTable objet à l’aide du nom spécifié et l’ajoute à la collection. |
| AddRange(DataTable[]) |
Copie les éléments du tableau spécifié DataTable à la fin de la collection. |
| CanRemove(DataTable) |
Vérifie si l’objet spécifié DataTable peut être supprimé de la collection. |
| Clear() |
Efface la collection de tous les DataTable objets. |
| Contains(String, String) |
Obtient une valeur qui indique si un DataTable objet portant le nom et l’espace de noms de table spécifiés existent dans la collection. |
| Contains(String) |
Obtient une valeur qui indique si un DataTable objet portant le nom spécifié existe dans la collection. |
| CopyTo(Array, Int32) |
Copie tous les éléments du courant InternalDataCollectionBase dans un index unidimensionnel Array, en commençant à l’index spécifié InternalDataCollectionBase . (Hérité de InternalDataCollectionBase) |
| CopyTo(DataTable[], Int32) |
Copie tous les éléments du courant DataTableCollection dans un index unidimensionnel Array, 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 une IEnumerator valeur pour la collection. (Hérité de InternalDataCollectionBase) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IndexOf(DataTable) |
Obtient l’index de l’objet spécifié DataTable . |
| IndexOf(String, String) |
Obtient l’index dans la collection de l’objet spécifié DataTable . |
| IndexOf(String) |
Obtient l’index dans la collection de l’objet DataTable avec le nom spécifié. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnCollectionChanged(CollectionChangeEventArgs) |
Déclenche l’événement OnCollectionChanged(CollectionChangeEventArgs). |
| OnCollectionChanging(CollectionChangeEventArgs) |
Représente la collection de tables pour le DataSet. |
| Remove(DataTable) |
Supprime l’objet spécifié DataTable de la collection. |
| Remove(String, String) |
Supprime l’objet DataTable avec le nom spécifié de la collection. |
| Remove(String) |
Supprime l’objet DataTable avec le nom spécifié de la collection. |
| RemoveAt(Int32) |
Supprime l’objet à l’index DataTable spécifié de la collection. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Événements
| Nom | Description |
|---|---|
| CollectionChanged |
Se produit après la modification de l’objet DataTableCollection en raison de l’ajout ou de la suppression d’objets DataTable . |
| CollectionChanging |
Se produit pendant la modification de l’objet DataTableCollection en raison d’objets DataTable ajoutés ou supprimés. |
Méthodes d’extension
| Nom | Description |
|---|---|
| AsParallel(IEnumerable) |
Active la parallélisation d’une requête. |
| AsQueryable(IEnumerable) |
Convertit un IEnumerable en IQueryable. |
| Cast<TResult>(IEnumerable) |
Convertit les éléments d’un IEnumerable en type spécifié. |
| OfType<TResult>(IEnumerable) |
Filtre les éléments d’une IEnumerable en fonction d’un type spécifié. |
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.