DataRowCollection-Klasse

Stellt eine Auflistung von Zeilen für eine DataTable dar.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public NotInheritable Class DataRowCollection
    Inherits InternalDataCollectionBase
'Usage
Dim instance As DataRowCollection

public sealed class DataRowCollection : InternalDataCollectionBase

public ref class DataRowCollection sealed : public InternalDataCollectionBase

public final class DataRowCollection extends InternalDataCollectionBase

public final class DataRowCollection extends InternalDataCollectionBase

Hinweise

Die DataRowCollection ist eine Hauptkomponente der DataTable. Während die DataColumnCollection das Schema der Tabelle definiert, enthält die DataRowCollection die eigentlichen Daten der Tabelle, wobei jede DataRow in der DataRowCollection eine einzelne Zeile darstellt.

Sie können die Add-Methode und die Remove-Methode aufrufen, um DataRow-Objekte in die DataRowCollection einzufügen bzw. aus dieser zu löschen. Sie können auch die Find-Methode aufrufen, um nach DataRow-Objekten mit bestimmten Werten in Primärschlüsselspalten zu suchen, und Sie können die Contains-Methode aufrufen, um zeichenbasierte Daten nach einzelnen Wörtern oder Ausdrücken zu durchsuchen.

Beispiel

Im ersten Beispiel dieses Abschnitts wird der Wert von Spalte 1 für die einzelnen Zeilen in einer DataRowCollection ausgegeben. Im zweiten Beispiel wird der DataRowCollection eine mit der NewRow-Methode erstellte neue Zeile hinzugefügt.

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

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);
}

Vererbungshierarchie

System.Object
   System.Data.InternalDataCollectionBase
    System.Data.DataRowCollection

Threadsicherheit

Dieser Typ ist bei Multithread-Lesevorgängen sicher. Sie müssen alle Schreibvorgänge synchronisieren.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataRowCollection-Member
System.Data-Namespace
DataRow-Klasse
DataTable
NewRow