DataColumnCollection Classe

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataColumnCollection.cs

Représente une collection d'objets DataColumn pour 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 les 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 DataTableet détermine le type de données que chacun DataColumn peut contenir. Vous pouvez accéder à via DataColumnCollection la Columns propriété de l’objet DataTable .

utilise les Add méthodes et Remove pour insérer et supprimer DataColumn des DataColumnCollection 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 nom d’index ou de colonne spécifié existe dans la collection.

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 DataColumn à partir de la collection, à l'index spécifié.
Item[String]	Obtient de la collection le DataColumn portant 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 et ajoute un objet DataColumn à DataColumnCollection.
Add(DataColumn)	Crée et ajoute l'objet DataColumn spécifié à DataColumnCollection.
Add(String)	Crée et ajoute un objet DataColumn portant le nom spécifié à DataColumnCollection.
Add(String, Type)	Crée et ajoute un objet DataColumn portant le nom et le type spécifiés à DataColumnCollection.
Add(String, Type, String)	Crée et ajoute un objet DataColumn portant le nom, le type et l'expression spécifiés à DataColumnCollection.
AddRange(DataColumn[])	Copie les éléments du tableau DataColumn spécifié à la fin de la collection.
CanRemove(DataColumn)	Vérifie si une colonne spécifique peut être supprimée de la collection.
Clear()	Efface toutes les colonnes de la collection.
Contains(String)	Vérifie si la collection contient une colonne portant le nom spécifié.
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(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 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(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 ne respecte pas la casse).
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(DataColumn)	Supprime l'objet DataColumn spécifié de la collection.
Remove(String)	Supprime de la collection l'objet DataColumn portant le nom spécifié.
RemoveAt(Int32)	Supprime la colonne 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 lorsque la collection columns est modifiée, suite à l'ajout ou à la suppression d'une colonne.

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

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