DataColumnCollection Classe

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataColumnCollection.cs

Representa uma coleção de objetos DataColumn para um DataTable.

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

public sealed class DataColumnCollection : System.Data.InternalDataCollectionBase

type DataColumnCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataColumnCollection
Inherits InternalDataCollectionBase

Herança

Object

InternalDataCollectionBase

DataColumnCollection

Exemplos

O exemplo a seguir itera por meio de uma coleção de DataColumn objetos e imprime várias propriedades de cada coluna na coleção.

private void PrintDataTableColumnInfo(DataTable table)
{
    // Use a DataTable object's DataColumnCollection.
    DataColumnCollection columns = table.Columns;

    // Print the ColumnName and DataType for each column.
    foreach(DataColumn column in columns)
    {
        Console.WriteLine(column.ColumnName);
        Console.WriteLine(column.DataType);
    }
}

Private Sub PrintDataTableColumnInfo(table As DataTable)
    
    ' Use a DataTable object's DataColumnCollection.
    Dim columns As DataColumnCollection = table.Columns

    ' Print the ColumnName and DataType for each column.
    Dim column As DataColumn
    For Each column in columns
       Console.WriteLine(column.ColumnName)
       Console.WriteLine(column.DataType.ToString)
    Next
End Sub

Comentários

O DataColumnCollection define o esquema de um e determina que tipo de dados cada DataColumn um DataTablepode conter. Você pode acessar o DataColumnCollection por meio da Columns propriedade do DataTable objeto .

O DataColumnCollection usa os Add métodos e Remove para inserir e excluir DataColumn objetos. Use a Count propriedade para determinar quantos DataColumn objetos estão na coleção. Use o Contains método para verificar se um índice ou nome de coluna especificado existe na coleção.

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 DataColumn da coleção no índice especificado.
Item[String]	Obtém o DataColumn da coleção 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 e adiciona um objeto DataColumn ao DataColumnCollection.
Add(DataColumn)	Cria e adiciona o objeto especificado DataColumn ao DataColumnCollection.
Add(String)	Cria e adiciona um objeto DataColumn que tem o nome especificado ao DataColumnCollection.
Add(String, Type)	Cria e adiciona um objeto DataColumn que tem o nome e tipo especificado ao DataColumnCollection.
Add(String, Type, String)	Cria e adiciona um objeto DataColumn que tem o nome, tipo e expressão especificados ao DataColumnCollection.
AddRange(DataColumn[])	Copia os elementos da matriz DataColumn especificada para o fim da coleção.
CanRemove(DataColumn)	Verifica se uma coluna específica pode ser removida da coleção.
Clear()	Limpa a coleção de todas as colunas.
Contains(String)	Verifica se a coleção tem uma coluna com o nome especificado.
CopyTo(Array, Int32)	Copia todos os elementos do InternalDataCollectionBase atual para um Array unidimensional, começando no índice InternalDataCollectionBase especificado. (Herdado de InternalDataCollectionBase)
CopyTo(DataColumn[], Int32)	Copia toda a coleção para uma matriz existente, iniciando em um índice especificado na matriz.
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(DataColumn)	Obtém o índice de uma coluna especificada pelo nome.
IndexOf(String)	Obtém o índice da coluna com o nome específico (o nome não diferencia maiúsculas de minúsculas).
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(DataColumn)	Remove o objeto DataColumn especificado da coleção.
Remove(String)	Remove da coleção o objeto DataColumn que tem o nome especificado.
RemoveAt(Int32)	Remove a coluna no índice especificado da coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

CollectionChanged

Ocorre quando uma coleção de colunas é alterada, seja pela inclusão ou pela remoção de uma coluna.

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

• Columns
• DataColumn
• DataTable
• DataRelation
• DataRow
• DataSet