DataRowCollection DataRowCollection DataRowCollection DataRowCollection Class

Definição

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

Exemplos

O primeiro exemplo nesta seção imprime o valor da coluna 1 para cada linha em um DataRowCollection.The first example in this section prints the value of column 1 for every row in a DataRowCollection. O segundo exemplo adiciona uma nova linha criada usando o NewRow método para o 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

Comentários

O DataRowCollection é um componente principal do DataTable.The DataRowCollection is a major component of the DataTable. Enquanto o DataColumnCollection define o esquema da tabela, o DataRowCollection contém os dados reais para a tabela, onde cada DataRow no DataRowCollection representa uma única linha.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.

Você pode chamar o Add e Remove métodos para inserir e excluir DataRow objetos o DataRowCollection.You can call the Add and Remove methods to insert and delete DataRow objects from the DataRowCollection. Você também pode chamar o Find método a ser pesquisado DataRow objetos que contêm valores específicos nas colunas de chave primária, e o Contains método para pesquisar dados baseados em caracteres, palavras ou frases.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.

Para outras operações, como classificar ou filtrar a DataRowCollection, use métodos na DataRowCollectionassociada do DataTable.For other operations, such as sorting or filtering the DataRowCollection, use methods on the DataRowCollection's associated DataTable.

Propriedades

Count Count Count Count

Obtém o número total de objetos DataRow nesta coleção.Gets the total number of DataRow objects in this collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtém um valor que indica se o InternalDataCollectionBase é somente leitura.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Inherited from InternalDataCollectionBase)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtém um valor que indica se o InternalDataCollectionBase é sincronizado.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Inherited from InternalDataCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtém a linha no índice especificado.Gets the row at the specified index.

List List List List

Obtém os itens da coleção como uma lista.Gets the items of the collection as a list.

(Inherited from InternalDataCollectionBase)
SyncRoot SyncRoot SyncRoot SyncRoot

Obtém um objeto que pode ser usado para sincronizar a coleção.Gets an object that can be used to synchronize the collection.

(Inherited from InternalDataCollectionBase)

Métodos

Add(DataRow) Add(DataRow) Add(DataRow) Add(DataRow)

Adiciona o DataRow especificado ao objeto DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Cria uma linha usando os valores especificados e a adiciona ao DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

Clear() Clear() Clear() Clear()

Limpa a coleção de todas as linhas.Clears the collection of all rows.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

Obtém um valor que indica se a chave primária de qualquer linha na coleção contém o valor especificado.Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

Contains(Object[]) Contains(Object[]) Contains(Object[]) 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.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) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia todos os objetos DataRow da coleção para a matriz fornecida, começando pelo índice da matriz de destino especificado.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32) CopyTo(DataRow[], Int32)

Copia todos os objetos DataRow da coleção para a matriz fornecida, começando pelo índice da matriz de destino especificado.Copies all the DataRow objects from the collection into the given array, starting at the given destination array index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Find(Object) Find(Object) Find(Object) Find(Object)

Obtém a linha especificada pelo valor da chave primária.Gets the row specified by the primary key value.

Find(Object[]) Find(Object[]) Find(Object[]) Find(Object[])

Obtém a linha que contém os valores de chave primária especificados.Gets the row that contains the specified primary key values.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Obtém um IEnumerator para essa coleção.Gets an IEnumerator for this collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(DataRow) IndexOf(DataRow) IndexOf(DataRow) IndexOf(DataRow)

Obtém o índice do objeto DataRow especificado.Gets the index of the specified DataRow object.

InsertAt(DataRow, Int32) InsertAt(DataRow, Int32) InsertAt(DataRow, Int32) InsertAt(DataRow, Int32)

Insere uma nova linha na coleção na localização especificada.Inserts a new row into the collection at the specified location.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(DataRow) Remove(DataRow) Remove(DataRow) Remove(DataRow)

Remove o DataRow especificado da coleção.Removes the specified DataRow from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Remove a linha no índice especificado da coleção.Removes the row at the specified index from the collection.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Métodos de Extensão

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread.This type is safe for multithreaded read operations. Você deve sincronizar todas as operações de gravação.You must synchronize any write operations.

Veja também