Compartilhar via


DataTableCollection Classe

Definição

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

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

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 DataTableCollectionadiciona ao .

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

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

Os DataTableCollection métodos de uso, 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 a DataTable propriedade do para acessar sua coleção de DataRelation objetos. Você também pode usar a Relations propriedade para navegar pelas relações pai/filho de DataTables uma coleção específica DataSet .

Propriedades

Nome Description
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 valor é somente leitura.

(Herdado de InternalDataCollectionBase)
IsSynchronized

Obtém um valor que indica se o InternalDataCollectionBase valor 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 namespace especificado.

Item[String]

Obtém o DataTable objeto com o nome especificado.

List

Obtém os itens da coleção como uma lista.

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

Nome 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 da matriz especificada 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 namespace de tabela especificados na coleção.

Contains(String)

Obtém 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 unidimensional Array, começando no índice especificado InternalDataCollectionBase .

(Herdado de InternalDataCollectionBase)
CopyTo(DataTable[], Int32)

Copia todos os elementos da corrente DataTableCollection para um unidimensional Array, começando no índice de 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 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 Objectatual.

(Herdado de Object)
OnCollectionChanged(CollectionChangeEventArgs)

Aciona o evento OnCollectionChanged(CollectionChangeEventArgs).

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

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

Nome Description
CollectionChanged

Ocorre depois que o DataTableCollection objeto é alterado devido DataTable a objetos sendo adicionados ou removidos.

CollectionChanging

Ocorre durante a DataTableCollection alteração devido a DataTable objetos sendo adicionados ou removidos.

Métodos de Extensão

Nome Description
AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.

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.

Aplica-se a

Acesso thread-safe

Esse tipo é seguro para operações de leitura multithreaded. Você deve sincronizar todas as operações de gravação.

Confira também