DataRowCollection DataRowCollection DataRowCollection DataRowCollection Class

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 erste Beispiel in diesem Abschnitt gibt den Wert der Spalte 1 für jede Zeile in einer DataRowCollection.The first example in this section prints the value of column 1 for every row in a DataRowCollection. Im zweite Beispiel fügt eine neue Zeile erstellt mithilfe der NewRow Methode, um die DataRowCollection.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

Die DataRowCollection ist eine wichtige Komponente von der DataTable.The DataRowCollection is a major component of the DataTable. Während der DataColumnCollection definiert das Schema der Tabelle, die DataRowCollection enthält die tatsächlichen Daten für die Tabelle, in dem jede DataRow in die DataRowCollection stellt eine einzelne Zeile dar.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.

Rufen Sie die Add und Remove Methoden zum Einfügen und Löschen von DataRow Objekte aus der DataRowCollection.You can call the Add and Remove methods to insert and delete DataRow objects from the DataRowCollection. Sie können auch aufrufen, die Find Methode zum Suchen nach DataRow Objekte, die bestimmte Werte in den Schlüsselspalten enthalten, und die Contains Methode, um die zeichenbasierte Daten nach einzelnen Wörtern oder Ausdrücken zu suchen.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.

Für andere Vorgänge, z. B. Sortierung oder Filterung der DataRowCollection, verwenden Sie Methoden auf die DataRowCollectionzugeordneten DataTable.For other operations, such as sorting or filtering the DataRowCollection, use methods on the DataRowCollection's associated DataTable.

Eigenschaften

Count Count Count Count

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

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

(Inherited from InternalDataCollectionBase)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

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

(Inherited from InternalDataCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

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

List List List List

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

(Inherited from InternalDataCollectionBase)
SyncRoot SyncRoot SyncRoot SyncRoot

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

(Inherited from InternalDataCollectionBase)

Methoden

Add(DataRow) Add(DataRow) Add(DataRow) Add(DataRow)

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

Add(Object[]) Add(Object[]) Add(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() Clear() Clear() Clear()

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

Contains(Object) Contains(Object) Contains(Object) 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[]) Contains(Object[]) Contains(Object[]) 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) CopyTo(Array, Int32) CopyTo(Array, Int32) 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) CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32) 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) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. Determines whether the specified object is equal to the current object.

(Inherited from Object)
Find(Object) Find(Object) Find(Object) Find(Object)

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

Find(Object[]) Find(Object[]) Find(Object[]) Find(Object[])

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

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion. Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(DataRow) IndexOf(DataRow) IndexOf(DataRow) IndexOf(DataRow)

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

InsertAt(DataRow, Int32) InsertAt(DataRow, Int32) InsertAt(DataRow, Int32) 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(DataRow) Remove(DataRow) Remove(DataRow) Remove(DataRow)

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

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

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

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) 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) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

Gilt für:

Threadsicherheit

Dieser Typ ist für schreibgeschützte Vorgänge mit mehreren Threads sicher. This type is safe for multithreaded read operations. Sie müssen die Schreibvorgänge synchronisieren. You must synchronize any write operations.

Siehe auch