DataTableCollection 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 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
- 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 |
| 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.