DataRowCollection Klasse

Definition

Stellt eine Auflistung von Zeilen für eine DataTable dar.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
Vererbung
Attribute

Beispiele

Im ersten Beispiel in diesem Abschnitt wird der Wert der Spalte 1 für jede Zeile in einer DataRowCollectionausgegeben.The first example in this section prints the value of column 1 for every row in a DataRowCollection. Im zweiten Beispiel wird eine neue Zeile hinzugefügt, die mit der NewRow-Methode zum DataRowCollectionerstellt wurde.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

Hinweise

Der DataRowCollection ist eine Hauptkomponente des DataTable.The DataRowCollection is a major component of the DataTable. Während der DataColumnCollection das Schema der Tabelle definiert, enthält die DataRowCollection die eigentlichen Daten für die Tabelle, wobei jede DataRow in der DataRowCollection eine einzelne Zeile darstellt.While 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.

Sie können die Methoden Add und Remove zum Einfügen und Löschen von DataRow Objekten aus der DataRowCollectionaufzurufen.You can call the Add and Remove methods to insert and delete DataRow objects from the DataRowCollection. Sie können auch die Find-Methode aufzurufen, um nach DataRow Objekten zu suchen, die bestimmte Werte in Primärschlüssel Spalten enthalten, und die Contains-Methode, um zeichenbasierte Daten nach einzelnen Wörtern oder Ausdrücken zu durchsuchen.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.

Verwenden Sie für andere Vorgänge, z. b. das Sortieren oder Filtern der DataRowCollection, Methoden für die zugeordneten DataTabledes DataRowCollection.For other operations, such as sorting or filtering the DataRowCollection, use methods on the DataRowCollection's associated DataTable.

Eigenschaften

Count

Ruft die Gesamtanzahl der DataRow-Objekte in dieser Auflistung ab.Gets the total number of DataRow objects in this collection.

IsReadOnly

Ruft einen Wert ab, der angibt, ob die InternalDataCollectionBase schreibgeschützt ist.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Geerbt von InternalDataCollectionBase)
IsSynchronized

Ruft einen Wert ab, der angibt, ob die InternalDataCollectionBase synchronisiert ist.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Geerbt von InternalDataCollectionBase)
Item[Int32]

Ruft die Zeile am angegebenen Index ab.Gets the row at the specified index.

List

Ruft die Elemente der Auflistung als Liste ab.Gets the items of the collection as a list.

(Geerbt von InternalDataCollectionBase)
SyncRoot

Ruft ein Objekt ab, mit dem die Auflistung synchronisiert werden kann.Gets an object that can be used to synchronize the collection.

(Geerbt von InternalDataCollectionBase)

Methoden

Add(DataRow)

Fügt dem DataRow-Objekt die angegebene DataRowCollection hinzu.Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

Erstellt eine Zeile mit den angegebenen Werten und fügt diese der DataRowCollection hinzu.Creates a row using specified values and adds it to the DataRowCollection.

Clear()

Löscht alle Zeilen aus der Auflistung.Clears the collection of all rows.

Contains(Object)

Ruft einen Wert ab, der angibt, ob der Primärschlüssel einer Zeile in der Auflistung den angegebenen Wert enthält.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

Contains(Object[])

Ruft einen Wert ab, der angibt, ob die Primärschlüsselspalten der Zeilen in der Auflistung die im Objektarray angegebenen Werte enthalten.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)

Kopiert alle DataRow-Objekte ab dem angegebenen Index aus der Auflistung in das angegebene Array ab dem angegebenen Index im Zielarray.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

CopyTo(DataRow[], Int32)

Kopiert alle DataRow-Objekte ab dem angegebenen Index aus der Auflistung in das angegebene Array ab dem angegebenen Index im Zielarray.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Find(Object)

Ruft die durch den Primärschlüsselwert angegebene Zeile ab.Gets the row specified by the primary key value.

Find(Object[])

Ruft die Zeile mit den angegebenen Primärschlüsselwerten ab.Gets the row that contains the specified primary key values.

GetEnumerator()

Ruft einen IEnumerator für diese Auflistung ab.Gets an IEnumerator for this collection.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IndexOf(DataRow)

Ruft den Index des angegebenen DataRow-Objekts ab.Gets the index of the specified DataRow object.

InsertAt(DataRow, Int32)

Fügt eine neue Zeile an der angegebenen Position in die Auflistung ein.Inserts a new row into the collection at the specified location.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
Remove(DataRow)

Entfernt den angegebenen DataRow aus der Auflistung.Removes the specified DataRow from the collection.

RemoveAt(Int32)

Entfernt die Zeile am angegebenen Index aus der Auflistung.Removes the row at the specified index from the collection.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Threadsicherheit

Dieser Typ ist für multithreadlesevorgänge sicher.This type is safe for multithreaded read operations. Sie müssen alle Schreibvorgänge synchronisieren.You must synchronize any write operations.

Siehe auch