DataRowCollection Classe

Definição

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

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

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 defina o DataColumnCollection esquema da tabela, ele contém os DataRowCollection dados reais da tabela, em que cada DataRow uma delas DataRowCollection representa uma única linha.

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

Para outras operações, como classificação ou filtragem, DataRowCollectionuse métodos nos DataRowCollection's associados DataTable.

Propriedades

Count

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

Count

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

(Herdado de InternalDataCollectionBase)
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
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(Array, Int32)

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

(Herdado de InternalDataCollectionBase)
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.

GetEnumerator()

Obtém um IEnumerator para a coleção.

(Herdado de InternalDataCollectionBase)
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.

Aplica-se a

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