DataTableCollection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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 |
| 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.