DataRowCollection Класс

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Исходный код:

DataRowCollection.cs

Представляет коллекцию строк для объекта DataTable.

public ref class DataRowCollection sealed : System::Data::InternalDataCollectionBase

public sealed class DataRowCollection : System.Data.InternalDataCollectionBase

type DataRowCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataRowCollection
Inherits InternalDataCollectionBase

Наследование

Object

InternalDataCollectionBase

DataRowCollection

Примеры

В первом примере в этом разделе выводится значение столбца 1 для каждой DataRowCollectionстроки в . Во втором примере добавляется новая строка, созданная с помощью метода , NewRow в 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

Комментарии

является DataRowCollection основным компонентом DataTable. DataColumnCollection В то время как определяет схему таблицы, DataRowCollection содержит фактические данные для таблицы, где каждый DataRow в DataRowCollection представляет одну строку.

Можно вызвать методы Add и Remove для вставки и удаления DataRow объектов из DataRowCollection. Можно также вызвать Find метод для DataRow поиска объектов, содержащих определенные значения в столбцах первичного ключа, и Contains метод для поиска символьных данных по отдельным словам или фразам.

Для других операций, таких как сортировка DataRowCollectionили фильтрация , используйте методы в связанном объекте DataRowCollectionDataTable.

Свойства

Count	Возвращает общее число объектов DataRow в коллекции.
IsReadOnly	Получает значение, указывающее, доступен ли объект InternalDataCollectionBase только для чтения. (Унаследовано от InternalDataCollectionBase)
IsSynchronized	Возвращает значение, которое определяет, является ли коллекция InternalDataCollectionBase синхронизированной. (Унаследовано от InternalDataCollectionBase)
Item[Int32]	Возвращает строку по указанному индексу.
List	Возвращает элементы коллекции в виде списка. (Унаследовано от InternalDataCollectionBase)
SyncRoot	Возвращает объект, который можно использовать для синхронизации коллекции. (Унаследовано от InternalDataCollectionBase)

Методы

Add(DataRow)	Добавляет заданный объект DataRow в объект DataRowCollection.
Add(Object[])	Создает строку с использованием заданных параметров и добавляет его в DataRowCollection.
Clear()	Удаляет все строки из коллекции.
Contains(Object)	Возвращает значение, которое указывает, содержит ли первичный ключ любой из строк в коллекции указанное значение.
Contains(Object[])	Возвращает значение, которое указывает, содержат ли столбцы первичного ключа любой из строк в коллекции значение, указанное в массиве объектов.
CopyTo(Array, Int32)	Копирует все объекты DataRow из этой коллекции в заданный целевой массив, начиная с указанного индекса.
CopyTo(DataRow[], Int32)	Копирует все объекты DataRow из этой коллекции в заданный целевой массив, начиная с указанного индекса.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Find(Object)	Возвращает строку, указанную значением первичного ключа.
Find(Object[])	Возвращает строку, которая содержит указанные значения первичного ключа.
GetEnumerator()	Возвращает IEnumerator для этой коллекции.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(DataRow)	Возвращает индекс указанного объекта DataRow.
InsertAt(DataRow, Int32)	Вставляет новую строку в коллекцию в указанное положение.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove(DataRow)	Удаляет указанный объект DataRow из коллекции.
RemoveAt(Int32)	Удаляет строку по указанному индексу из коллекции.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Методы расширения

Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

Потокобезопасность

Этот тип безопасен для многопоточных операций чтения. Необходимо синхронизировать все операции записи.

См. также раздел

• DataRow
• DataTable
• NewRow()