DataRowCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.