DataRowCollection Classe

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataRowCollection.cs

Représente une collection de lignes pour DataTable.

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

public sealed class DataRowCollection : System.Data.InternalDataCollectionBase

type DataRowCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataRowCollection
Inherits InternalDataCollectionBase

Héritage

Object

InternalDataCollectionBase

DataRowCollection

Exemples

Le premier exemple de cette section imprime la valeur de la colonne 1 pour chaque ligne d’un DataRowCollection. Le deuxième exemple ajoute une nouvelle ligne créée à l’aide de la NewRow méthode à .DataRowCollection

private void ShowRows(DataTable table)
{
    // Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count);
    // Print the value of columns 1 in each row
    foreach(DataRow row in table.Rows)
    {
        Console.WriteLine(row[1]);
    }
}

private void AddRow(DataTable table)
{
    DataRowCollection rowCollection = table.Rows;
    // Instantiate a new row using the NewRow method.

    DataRow newRow = table.NewRow();
    // Insert code to fill the row with values.

    // Add the row to the DataRowCollection.
    table.Rows.Add(newRow);
}

Private Sub ShowRows(Byval table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

Remarques

est DataRowCollection un composant majeur de .DataTable Bien que le DataColumnCollection définit le schéma de la table, contient DataRowCollection les données réelles de la table, où chacune DataRow dans le DataRowCollection représente une seule ligne.

Vous pouvez appeler les Add méthodes et Remove pour insérer et supprimer DataRow des objets du DataRowCollection. Vous pouvez également appeler la Find méthode pour rechercher DataRow des objets qui contiennent des valeurs spécifiques dans les colonnes de clé primaire, et la Contains méthode pour rechercher des mots ou des expressions uniques dans des données basées sur des caractères.

Pour d’autres opérations, telles que le tri ou le filtrage , utilisez des DataRowCollectionméthodes sur le DataRowCollectionassocié DataTablede .

Propriétés

Count	Obtient le nombre total d'objets DataRow dans cette collection.
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 la ligne à l'index 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(DataRow)	Ajoute le DataRow spécifié à l'objet DataRowCollection.
Add(Object[])	Crée une ligne à l'aide des valeurs spécifiées et l'ajoute à DataRowCollection.
Clear()	Efface toutes les lignes de la collection.
Contains(Object)	Obtient une valeur qui indique si la clé primaire d'une ligne quelconque de la collection contient la valeur spécifiée.
Contains(Object[])	Obtient une valeur qui indique si les colonnes clés primaires d'une ligne quelconque de la collection contiennent les valeurs spécifiées dans le tableau d'objets.
CopyTo(Array, Int32)	Copie tous les objets DataRow de la collection dans le tableau donné, en commençant à l'index de tableau de destination spécifié.
CopyTo(DataRow[], Int32)	Copie tous les objets DataRow de la collection dans le tableau donné, 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)
Find(Object)	Obtient la ligne spécifiée par la valeur de clé primaire.
Find(Object[])	Obtient la ligne qui contient les valeurs de clés primaires spécifiées.
GetEnumerator()	Obtient un IEnumerator de cette collection.
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(DataRow)	Obtient l'index de l'objet DataRow spécifié.
InsertAt(DataRow, Int32)	Insère une nouvelle ligne dans la collection à l'emplacement spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(DataRow)	Supprime l’objet DataRow spécifié de la collection.
RemoveAt(Int32)	Supprime la ligne de la collection à l'index spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

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

• DataRow
• DataTable
• NewRow()