DataTableCollection Classe

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataTableCollection.cs

Representa a coleção de tabelas para o DataSet.

public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase

[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase

[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase

Herança

Object

InternalDataCollectionBase

DataTableCollection

Atributos

ListBindableAttribute

Exemplos

O primeiro procedimento neste exemplo recupera o DataTableCollection de um DataSet e imprime o valor de cada coluna, em cada linha, de cada tabela. O segundo procedimento cria um novo DataTable com duas colunas e o adiciona ao DataTableCollection.

private void GetTables(DataSet dataSet)
{
    // Get Each DataTable in the DataTableCollection and
    // print each row value.
    foreach (DataTable table in dataSet.Tables)
        foreach (DataRow row in table.Rows)
            foreach (DataColumn column in table.Columns)
                if (row[column] != null)
                    Console.WriteLine(row[column]);
}

private void CreateTable(DataSet dataSet)
{
    DataTable newTable = new DataTable("table");
    newTable.Columns.Add("ID", typeof(int));
    newTable.Columns.Add("Name", typeof(string));
    dataSet.Tables.Add(newTable);
}

Private Sub GetTables(dataSet As DataSet)
   ' Get Each DataTable in the DataTableCollection and 
   ' print each row value.
   Dim table As DataTable
   Dim row As DataRow
   Dim column As DataColumn
   For Each table In dataSet.Tables
      For Each row In table.Rows
         For Each column in table.Columns
            If Not (row(column) Is Nothing) Then
               Console.WriteLine(row(column))
            End If
         Next
      Next
   Next
End Sub

Private Sub CreateTable(dataSet As DataSet)
   Dim newTable As New DataTable("table")
   newTable.Columns.Add("ID", Type.GetType("System.Int32"))
   newTable.Columns.Add("Name", Type.GetType("System.String"))
   dataSet.Tables.Add(newTable)
End Sub

Comentários

O DataTableCollection contém todos os DataTable objetos para um determinado DataSet. Para acessar o DataTableCollection de um DataSet, use a Tables propriedade .

O DataTableCollection usa métodos como Add, Cleare Remove para gerenciar os itens na coleção.

Use o Contains método para determinar se uma tabela específica (especificada por índice ou nome) está na coleção.

Para navegar de uma tabela para outra, use a ChildRelations propriedade ou ParentRelations do DataTable para acessar sua coleção de DataRelation objetos. Você também pode usar a Relations propriedade para navegar pelas relações pai/filho do DataTables em uma coleção específica DataSet .

Propriedades

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 o objeto DataTable no índice especificado.
Item[String, String]	Obtém o objeto DataTable com o nome especificado no namespace especificado.
Item[String]	Obtém o objeto DataTable com o nome 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()	Cria um novo objeto DataTable usando um nome padrão e o adiciona à coleção.
Add(DataTable)	Adiciona o DataTable especificado à coleção.
Add(String)	Cria um objeto DataTable usando o nome especificado e o adiciona à coleção.
Add(String, String)	Cria um objeto DataTable usando o nome especificado e o adiciona à coleção.
AddRange(DataTable[])	Copia os elementos da matriz DataTable especificada para o fim da coleção.
CanRemove(DataTable)	Verifica se o objeto DataTable especificado pode ser removido da coleção.
Clear()	Limpa a coleção de todos os objetos DataTable.
Contains(String)	Obtém um valor que indica se um objeto DataTable com o nome especificado existe na coleção.
Contains(String, String)	Obtém um valor que indica se um objeto DataTable com o nome e o namespace de tabela especificados existe na coleção.
CopyTo(Array, Int32)	Copia todos os elementos do InternalDataCollectionBase atual para um Array unidimensional, começando no índice InternalDataCollectionBase especificado. (Herdado de InternalDataCollectionBase)
CopyTo(DataTable[], Int32)	Copia todos os elementos do DataTableCollection atual para um Array unidimensional, começando no índice da matriz de destino especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
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(DataTable)	Obtém o índice do objeto DataTable especificado.
IndexOf(String)	Obtém o índice na coleção do objeto DataTable com o nome especificado.
IndexOf(String, String)	Obtém o índice na coleção do objeto DataTable especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(DataTable)	Remove o objeto DataTable especificado da coleção.
Remove(String)	Remove o objeto DataTable com o nome especificado da coleção.
Remove(String, String)	Remove o objeto DataTable com o nome especificado da coleção.
RemoveAt(Int32)	Remove o objeto DataTable no índice especificado da coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

CollectionChanged	Ocorre após o DataTableCollection ser alterado devido aos objetos DataTable sendo adicionados ou removidos.
CollectionChanging	Ocorre enquanto o DataTableCollection está sendo alterado devido aos objetos DataTable sendo adicionados ou removidos.

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

• DataColumn
• DataRow
• DataTable
• DataSet