DataRowCollection Classe

Definição

Representa uma coleção de linhas para um DataTable.

public ref class DataRowCollection : System::Data::InternalDataCollectionBase
public ref class DataRowCollection sealed : System::Data::InternalDataCollectionBase
[System.Serializable]
public class DataRowCollection : System.Data.InternalDataCollectionBase
public sealed class DataRowCollection : System.Data.InternalDataCollectionBase
[<System.Serializable>]
type DataRowCollection = class
    inherit InternalDataCollectionBase
type DataRowCollection = class
    inherit InternalDataCollectionBase
Public Class DataRowCollection
Inherits InternalDataCollectionBase
Public NotInheritable Class DataRowCollection
Inherits InternalDataCollectionBase
Herança
Atributos

Exemplos

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

Observações

O DataRowCollection é um componente principal do DataTable. Enquanto o DataColumnCollection define o esquema da tabela, o DataRowCollection contém os dados reais para a tabela, onde cada DataRow em representa DataRowCollection uma única linha.

Pode chamar os Add métodos e Remove para inserir e eliminar DataRow objetos do DataRowCollection. Também pode chamar o Find método para procurar DataRow objetos que contenham valores específicos em colunas de chave primárias, e o Contains método para pesquisar dados baseados em caracteres por palavras ou frases isoladas.

Para outras operações, como ordenar ou filtrar o DataRowCollection, use métodos nos DataRowCollection's associados DataTable.

Propriedades

Name Description
Count

Obtém o número total de DataRow objetos nesta coleção.

Count

Obtém o número total de elementos numa coleção.

(Herdado de InternalDataCollectionBase)
IsReadOnly

Obtém um valor que indica se o InternalDataCollectionBase é apenas de leitura.

(Herdado de InternalDataCollectionBase)
IsSynchronized

Obtém um valor que indica se o InternalDataCollectionBase está sincronizado.

(Herdado de InternalDataCollectionBase)
Item[Int32]

Obtém a linha no índice especificado.

List

Representa uma coleção de linhas para um DataTable.

List

Recebe os itens da coleção numa lista.

(Herdado de InternalDataCollectionBase)
SyncRoot

Obtém um objeto que pode ser usado para sincronizar a coleção.

(Herdado de InternalDataCollectionBase)

Métodos

Name Description
Add(DataRow)

Adiciona o especificado DataRow ao DataRowCollection objeto.

Add(Object[])

Cria uma linha usando valores especificados e adiciona-a ao DataRowCollection.

Clear()

Limpa a coleção de todas as linhas.

Contains(Object)

Recebe um valor que indica se a chave primária de qualquer linha da coleção contém o valor especificado.

Contains(Object[])

Obtém um valor que indica se as colunas principais de qualquer linha da coleção contêm os valores especificados no array de objetos.

CopyTo(Array, Int32)

Copia todos os DataRow objetos da coleção para o array dado, começando no índice do array de destino.

CopyTo(Array, Int32)

Copia todos os elementos da corrente InternalDataCollectionBase para um índice unidimensional Array, começando no índice especificado InternalDataCollectionBase .

(Herdado de InternalDataCollectionBase)
CopyTo(DataRow[], Int32)

Copia todos os DataRow objetos da coleção para o array dado, começando no índice do array de destino.

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()

Recebe um IEnumerator para esta coleção.

GetEnumerator()

Recebe um IEnumerator para a coleção.

(Herdado de InternalDataCollectionBase)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(DataRow)

Obtém o índice do objeto especificado DataRow .

InsertAt(DataRow, Int32)

Insere uma nova linha na coleção no local especificado.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Remove(DataRow)

Remove o especificado DataRow da coleção.

RemoveAt(Int32)

Remove a linha no índice especificado da coleção.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.

Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Segurança de Thread

Este tipo é seguro para operações de leitura multithread. Tem de sincronizar quaisquer operações de escrita.

Ver também