DataRowCollection Třída

Definice

Představuje kolekci řádků pro 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
Dědičnost
Atributy

Příklady

První příklad v této části vytiskne hodnotu sloupce 1 pro každý řádek v DataRowCollection.The first example in this section prints the value of column 1 for every row in a DataRowCollection. Druhý příklad přidá nový řádek vytvořený pomocí metody NewRow do 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

Poznámky

DataRowCollection je hlavní součástí DataTable.The DataRowCollection is a major component of the DataTable. I když DataColumnCollection definuje schéma tabulky, DataRowCollection obsahuje skutečná data pro tabulku, kde každý DataRow v DataRowCollection představuje jeden řádek.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.

Můžete volat Add a Remove metody pro vkládání a odstraňování objektů DataRow z DataRowCollection.You can call the Add and Remove methods to insert and delete DataRow objects from the DataRowCollection. Můžete také volat metodu Find pro hledání DataRow objektů, které obsahují konkrétní hodnoty ve sloupcích primárního klíče, a metodu Contains pro hledání dat založených na znacích pro jednotlivá slova nebo fráze.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.

Pro jiné operace, jako je například řazení nebo filtrování DataRowCollection, použijte metody související DataTableDataRowCollection.For other operations, such as sorting or filtering the DataRowCollection, use methods on the DataRowCollection's associated DataTable.

Vlastnosti

Count

Získá celkový počet DataRow objektů v této kolekci.Gets the total number of DataRow objects in this collection.

IsReadOnly

Získá hodnotu, která označuje, zda je InternalDataCollectionBase jen pro čtení.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Zděděno od InternalDataCollectionBase)
IsSynchronized

Získá hodnotu, která označuje, zda je InternalDataCollectionBase synchronizována.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Zděděno od InternalDataCollectionBase)
Item[Int32]

Získá řádek v zadaném indexu.Gets the row at the specified index.

List

Načte položky kolekce jako seznam.Gets the items of the collection as a list.

(Zděděno od InternalDataCollectionBase)
SyncRoot

Získá objekt, který lze použít k synchronizaci kolekce.Gets an object that can be used to synchronize the collection.

(Zděděno od InternalDataCollectionBase)

Metody

Add(DataRow)

Přidá zadaný DataRow do objektu DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

Vytvoří řádek s použitím zadaných hodnot a přidá jej do DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

Clear()

Vymaže kolekci všech řádků.Clears the collection of all rows.

Contains(Object)

Získá hodnotu, která označuje, zda primární klíč libovolného řádku v kolekci obsahuje zadanou hodnotu.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

Contains(Object[])

Načte hodnotu, která indikuje, jestli sloupce primárního klíče libovolného řádku v kolekci obsahují hodnoty zadané v poli objektů.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)

Zkopíruje všechny objekty DataRow z kolekce do daného pole, počínaje zadaným indexem cílového pole.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

CopyTo(DataRow[], Int32)

Zkopíruje všechny objekty DataRow z kolekce do daného pole, počínaje zadaným indexem cílového pole.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

Equals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
Find(Object)

Získá řádek určený hodnotou primárního klíče.Gets the row specified by the primary key value.

Find(Object[])

Získá řádek, který obsahuje zadané hodnoty primárního klíče.Gets the row that contains the specified primary key values.

GetEnumerator()

Získá IEnumerator pro tuto kolekci.Gets an IEnumerator for this collection.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.Gets the Type of the current instance.

(Zděděno od Object)
IndexOf(DataRow)

Získá index zadaného objektu DataRow.Gets the index of the specified DataRow object.

InsertAt(DataRow, Int32)

Vloží nový řádek do kolekce v zadaném umístění.Inserts a new row into the collection at the specified location.

MemberwiseClone()

Vytvoří kopii aktuálního Objectbez podstruktury.Creates a shallow copy of the current Object.

(Zděděno od Object)
Remove(DataRow)

Odstraní zadaný DataRow z kolekce.Removes the specified DataRow from the collection.

RemoveAt(Int32)

Odebere z kolekce řádek se zadaným indexem.Removes the row at the specified index from the collection.

ToString()

Vrací řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Metody rozšíření

Cast<TResult>(IEnumerable)

Přetypování prvky IEnumerable na zadaný typ.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje prvky IEnumerable založené na zadaném typu.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Povoluje paralelní zpracování dotazu.Enables parallelization of a query.

AsQueryable(IEnumerable)

Převede IEnumerable na IQueryable.Converts an IEnumerable to an IQueryable.

Platí pro

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení ve více vláknech.This type is safe for multithreaded read operations. Je nutné synchronizovat všechny operace zápisu.You must synchronize any write operations.

Viz také