DataRowCollection Classe

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataRowCollection.cs

Representa uma coleção de linhas para um 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

Herança

Object

InternalDataCollectionBase

DataRowCollection

Exemplos

O primeiro exemplo nesta seção imprime o valor da coluna 1 para cada linha em um DataRowCollection. O segundo exemplo adiciona uma nova linha criada usando o NewRow método ao 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

Comentários

O DataRowCollection é um componente principal do DataTable. Embora o DataColumnCollection defina o esquema da tabela, o DataRowCollection contém os dados reais da tabela, em que cada DataRow um no DataRowCollection representa uma única linha.

Você pode chamar os Add métodos e Remove para inserir e excluir DataRow objetos do DataRowCollection. Você também pode chamar o Find método para DataRow pesquisar objetos que contenham valores específicos em colunas de chave primária e o Contains método para pesquisar dados baseados em caracteres para palavras ou frases simples.

Para outras operações, como classificar ou filtrar o DataRowCollection, use métodos no DataRowCollectionassociado DataTabledo .

Propriedades

Count	Obtém o número total de objetos DataRow nesta coleção.
IsReadOnly	Obtém um valor que indica se o InternalDataCollectionBase é somente leitura. (Herdado de InternalDataCollectionBase)
IsSynchronized	Obtém um valor que indica se o InternalDataCollectionBase é sincronizado. (Herdado de InternalDataCollectionBase)
Item[Int32]	Obtém a linha no índice especificado.
List	Obtém os itens da coleção como uma lista. (Herdado de InternalDataCollectionBase)
SyncRoot	Obtém um objeto que pode ser usado para sincronizar a coleção. (Herdado de InternalDataCollectionBase)

Métodos

Add(DataRow)	Adiciona o DataRow especificado ao objeto DataRowCollection.
Add(Object[])	Cria uma linha usando os valores especificados e a adiciona ao DataRowCollection.
Clear()	Limpa a coleção de todas as linhas.
Contains(Object)	Obtém um valor que indica se a chave primária de qualquer linha na coleção contém o valor especificado.
Contains(Object[])	Obtém um valor que indica se as colunas de chave primária de qualquer linha na coleção contêm os valores especificados na matriz de objetos.
CopyTo(Array, Int32)	Copia todos os objetos DataRow da coleção para a matriz fornecida, começando pelo índice da matriz de destino especificado.
CopyTo(DataRow[], Int32)	Copia todos os objetos DataRow da coleção para a matriz fornecida, começando pelo índice da matriz de destino especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Find(Object)	Obtém a linha especificada pelo valor da chave primária.
Find(Object[])	Obtém a linha que contém os valores de chave primária especificados.
GetEnumerator()	Obtém um IEnumerator para essa coleção.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(DataRow)	Obtém o índice do objeto DataRow especificado.
InsertAt(DataRow, Int32)	Insere uma nova linha na coleção na localização especificada.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(DataRow)	Remove o DataRow especificado da coleção.
RemoveAt(Int32)	Remove a linha no índice especificado da coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread. Você deve sincronizar todas as operações de gravação.

Confira também

• DataRow
• DataTable
• NewRow()