DataColumnCollection Classe

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Source:

DataColumnCollection.cs

Représente une collection d’objets DataColumn pour un DataTable.

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

public sealed class DataColumnCollection : System.Data.InternalDataCollectionBase

type DataColumnCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataColumnCollection
Inherits InternalDataCollectionBase

Héritage

Object

InternalDataCollectionBase

DataColumnCollection

Exemples

L’exemple suivant itère dans une collection d’objets DataColumn et imprime différentes propriétés de chaque colonne de la collection.

private void PrintDataTableColumnInfo(DataTable table)
{
    // Use a DataTable object's DataColumnCollection.
    DataColumnCollection columns = table.Columns;

    // Print the ColumnName and DataType for each column.
    foreach(DataColumn column in columns)
    {
        Console.WriteLine(column.ColumnName);
        Console.WriteLine(column.DataType);
    }
}

Private Sub PrintDataTableColumnInfo(table As DataTable)
    
    ' Use a DataTable object's DataColumnCollection.
    Dim columns As DataColumnCollection = table.Columns

    ' Print the ColumnName and DataType for each column.
    Dim column As DataColumn
    For Each column in columns
       Console.WriteLine(column.ColumnName)
       Console.WriteLine(column.DataType.ToString)
    Next
End Sub

Remarques

Définit DataColumnCollection le schéma d’un DataTable, et détermine le type de données que chacun DataColumn peut contenir. Vous pouvez accéder au DataColumnCollection via la Columns propriété de l’objet DataTable .

Utilise DataColumnCollection les méthodes et Remove les Add méthodes pour insérer et supprimer des DataColumn objets. Utilisez la Count propriété pour déterminer le nombre d’objets DataColumn dans la collection. Utilisez la Contains méthode pour vérifier si un index ou un nom de colonne spécifié existe dans la collection.

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 la DataColumn collection à l’index spécifié.
Item[String]	Obtient la DataColumn collection avec le nom spécifié.
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 et ajoute un DataColumn objet au DataColumnCollection.
Add(DataColumn)	Crée et ajoute l’objet spécifié DataColumn à l’objet DataColumnCollection.
Add(String, Type, String)	Crée et ajoute un DataColumn objet qui a le nom, le type et l’expression spécifiés à l’objet DataColumnCollection.
Add(String, Type)	Crée et ajoute un DataColumn objet qui a le nom et le type spécifiés à l’objet DataColumnCollection.
Add(String)	Crée et ajoute un DataColumn objet qui a le nom spécifié à l’objet DataColumnCollection.
AddRange(DataColumn[])	Copie les éléments du tableau spécifié DataColumn à la fin de la collection.
CanRemove(DataColumn)	Vérifie si une colonne spécifique peut être supprimée de la collection.
Clear()	Efface la collection de toutes les colonnes.
Contains(String)	Vérifie si la collection contient une colonne portant le nom spécifié.
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(DataColumn[], Int32)	Copie l’intégralité de la collection dans un tableau existant, en commençant à un index spécifié dans le tableau.
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(DataColumn)	Obtient l’index d’une colonne spécifiée par son nom.
IndexOf(String)	Obtient l’index de la colonne portant le nom spécifique (le nom n’est pas sensible à la casse).
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Remove(DataColumn)	Supprime l’objet spécifié DataColumn de la collection.
Remove(String)	Supprime l’objet DataColumn qui a le nom spécifié de la collection.
RemoveAt(Int32)	Supprime la colonne à l’index 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 lorsque la collection de colonnes change, soit en ajoutant ou en supprimant une colonne.

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é.

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

• Columns
• DataColumn
• DataTable
• DataRelation
• DataRow
• DataSet