DataTableCollection Classe

Definição

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

public ref class DataTableCollection : System::Data::InternalDataCollectionBase
public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public class DataTableCollection : System.Data.InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type DataTableCollection = class
    inherit InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
    inherit InternalDataCollectionBase
Public Class DataTableCollection
Inherits InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Herança
DataTableCollection
Atributos

Exemplos

O primeiro procedimento neste exemplo recupera o DataTableCollection de a 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 adiciona-o 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

Observações

O DataTableCollection contém todos os DataTable objetos para um determinado DataSet. Para aceder ao DataTableCollection de um DataSet, utilize a Tables propriedade.

Utiliza DataTableCollection métodos como Add, Clear, e Remove para gerir os itens da 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 aceder à sua coleção de DataRelation objetos. Também pode usar a Relations propriedade para navegar pelas relações pai/filho de uma DataTables coleção específica DataSet .

Propriedades

Name Description
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 o DataTable objeto no índice especificado.

Item[String, String]

Obtém o DataTable objeto com o nome especificado no espaço de nomes especificado.

Item[String]

Obtém o DataTable objeto com o nome especificado.

List

Recebe os itens da coleção numa lista.

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

Cria um novo DataTable objeto usando um nome padrão e adiciona-o à coleção.

Add(DataTable)

Adiciona o especificado DataTable à coleção.

Add(String, String)

Cria um DataTable objeto usando o nome especificado e adiciona-o à coleção.

Add(String)

Cria um DataTable objeto usando o nome especificado e adiciona-o à coleção.

AddRange(DataTable[])

Copia os elementos do array especificado DataTable para o final da coleção.

CanRemove(DataTable)

Verifica se o objeto especificado DataTable pode ser removido da coleção.

Clear()

Limpa a coleção de todos os DataTable objetos.

Contains(String, String)

Obtém um valor que indica se existe um DataTable objeto com o nome e o espaço de nomes da tabela especificados na coleção.

Contains(String)

Recebe um valor que indica se existe um DataTable objeto com o nome especificado na coleção.

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(DataTable[], Int32)

Copia todos os elementos da corrente DataTableCollection para um índice unidimensional Array, começando no índice especificado do array de destino.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
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(DataTable)

Obtém o índice do objeto especificado DataTable .

IndexOf(String, String)

Obtém o índice na coleção do objeto especificado DataTable .

IndexOf(String)

Obtém o índice na coleção do DataTable objeto com o nome especificado.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnCollectionChanged(CollectionChangeEventArgs)

Eleva o OnCollectionChanged(CollectionChangeEventArgs) evento.

OnCollectionChanging(CollectionChangeEventArgs)

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

Remove(DataTable)

Remove o objeto especificado DataTable da coleção.

Remove(String, String)

Remove o DataTable objeto com o nome especificado da coleção.

Remove(String)

Remove o DataTable objeto com o nome especificado da coleção.

RemoveAt(Int32)

Remove o DataTable objeto no índice especificado da coleção.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
CollectionChanged

Ocorre depois de o DataTableCollection ser alterado devido à DataTable adição ou remoção de objetos.

CollectionChanging

Ocorre enquanto está DataTableCollection a mudar devido à DataTable adição ou remoção de objetos.

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