DataRowCollection Classe

Définition

Représente une collection de lignes pour DataTable.Represents a collection of rows for a DataTable.

public ref class DataRowCollection sealed : System::Data::InternalDataCollectionBase
[System.Serializable]
public sealed class DataRowCollection : System.Data.InternalDataCollectionBase
type DataRowCollection = class
    inherit InternalDataCollectionBase
Public NotInheritable Class DataRowCollection
Inherits InternalDataCollectionBase
Héritage
Attributs

Exemples

Le premier exemple de cette section imprime la valeur de la colonne 1 pour chaque ligne DataRowCollectiondans un.The first example in this section prints the value of column 1 for every row in a DataRowCollection. Le deuxième exemple ajoute une nouvelle ligne créée à l’aide NewRow DataRowCollectionde la méthode à.The second example adds a new row created by using the NewRow method to the 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 un composant majeur DataTablede. DataRowCollectionThe DataRowCollection is a major component of the DataTable. Tandis que DataRowCollection DataRow DataRowCollection définit le schéma de la table, contient les données réelles de la table, où chacune d’elles représente une seule ligne. DataColumnCollectionWhile the DataColumnCollection defines the schema of the table, the DataRowCollection contains the actual data for the table, where each DataRow in the DataRowCollection represents a single row.

Vous pouvez appeler les Add méthodes Remove et pour insérer DataRowCollectionet supprimer DataRow des objets de.You can call the Add and Remove methods to insert and delete DataRow objects from the DataRowCollection. Vous pouvez également appeler la Find méthode pour rechercher des DataRow objets qui contiennent des valeurs spécifiques dans les colonnes clés primaires, Contains et la méthode pour rechercher des mots uniques ou des expressions dans des données basées sur des caractères.You can also call the Find method to search for DataRow objects that contain specific values in primary key columns, and the Contains method to search character-based data for single words or phrases.

Pour d’autres opérations, telles que le tri ou DataRowCollectionle filtrage du, utilisez DataRowCollectiondes méthodes DataTablesur le associé.For other operations, such as sorting or filtering the DataRowCollection, use methods on the DataRowCollection's associated DataTable.

Propriétés

Count

Obtient le nombre total d'objets DataRow dans cette collection.Gets the total number of DataRow objects in this collection.

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.

(Hérité de InternalDataCollectionBase)
IsSynchronized

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

(Hérité de InternalDataCollectionBase)
Item[Int32]

Obtient la ligne à l'index spécifié.Gets the row at the specified index.

List

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

(Hérité de InternalDataCollectionBase)
SyncRoot

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

(Hérité de InternalDataCollectionBase)

Méthodes

Add(DataRow)

Ajoute le DataRow spécifié à l'objet DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

Crée une ligne à l'aide des valeurs spécifiées et l'ajoute à DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

Clear()

Efface toutes les lignes de la collection.Clears the collection of all rows.

Contains(Object)

Obtient une valeur qui indique si la clé primaire d'une ligne quelconque de la collection contient la valeur spécifiée.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

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.Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.

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é.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

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é.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

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.

(Hérité de Object)
Find(Object)

Obtient la ligne spécifiée par la valeur de clé primaire.Gets the row specified by the primary key value.

Find(Object[])

Obtient la ligne qui contient les valeurs de clés primaires spécifiées.Gets the row that contains the specified primary key values.

GetEnumerator()

Obtient un IEnumerator de cette collection.Gets an IEnumerator for this collection.

GetHashCode()

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

(Hérité de Object)
GetType()

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

(Hérité de Object)
IndexOf(DataRow)

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

InsertAt(DataRow, Int32)

Insère une nouvelle ligne dans la collection à l'emplacement spécifié.Inserts a new row into the collection at the specified location.

MemberwiseClone()

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

(Hérité de Object)
Remove(DataRow)

Supprime l’objet DataRow spécifié de la collection.Removes the specified DataRow from the collection.

RemoveAt(Int32)

Supprime la ligne de la collection à l'index spécifié.Removes the row at the specified index from the collection.

ToString()

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

(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é.Casts the elements of an IEnumerable to the specified type.

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)

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

AsQueryable(IEnumerable)

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

S’applique à

Cohérence de thread

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

Voir aussi