DataColumnCollection Clase

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Source:

DataColumnCollection.cs

Representa una colección de objetos DataColumn de una tabla 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

Herencia

Object

InternalDataCollectionBase

DataColumnCollection

Ejemplos

En el ejemplo siguiente se recorre en iteración una colección de DataColumn objetos e imprime varias propiedades de cada columna de la colección.

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

Comentarios

DataColumnCollection define el esquema de un DataTabley determina qué tipo de datos puede contener cada unoDataColumn. Puede acceder a DataColumnCollection a través de la Columns propiedad del DataTable objeto .

DataColumnCollection utiliza los Add métodos y Remove para insertar y eliminar DataColumn objetos. Utilice la Count propiedad para determinar cuántos DataColumn objetos hay en la colección. Use el Contains método para comprobar si existe un índice o un nombre de columna especificados en la colección.

Propiedades

Count	Obtiene el número total de elementos de una colección. (Heredado de InternalDataCollectionBase)
IsReadOnly	Obtiene un valor que indica si InternalDataCollectionBase es de solo lectura. (Heredado de InternalDataCollectionBase)
IsSynchronized	Obtiene un valor que indica si el objeto InternalDataCollectionBase está sincronizado. (Heredado de InternalDataCollectionBase)
Item[Int32]	Obtiene el objeto DataColumn de la colección en el índice especificado.
Item[String]	Obtiene el objeto DataColumn de la colección con el nombre especificado.
List	Obtiene los elementos de una colección en forma de lista. (Heredado de InternalDataCollectionBase)
SyncRoot	Obtiene un objeto que se puede utilizar para sincronizar la colección. (Heredado de InternalDataCollectionBase)

Métodos

Add()	Crea y agrega un objeto DataColumn a la colección DataColumnCollection.
Add(DataColumn)	Crea y agrega el objeto DataColumn especificado a la colección DataColumnCollection.
Add(String)	Crea un objeto DataColumn que tiene el nombre especificado y lo agrega a la colección DataColumnCollection.
Add(String, Type)	Crea un objeto DataColumn que tiene el nombre y tipo especificados y lo agrega a la colección DataColumnCollection.
Add(String, Type, String)	Crea un objeto DataColumn que tiene el nombre, tipo y expresión especificados y lo agrega a la colección DataColumnCollection.
AddRange(DataColumn[])	Copia los elementos de la matriz DataColumn especificada al final de la colección.
CanRemove(DataColumn)	Comprueba si una columna especificada se puede quitar de la colección.
Clear()	Borra la colección de todas las columnas.
Contains(String)	Comprueba si la colección contiene una columna con el nombre especificado.
CopyTo(Array, Int32)	Copia todos los elementos del InternalDataCollectionBase actual en un Array unidimensional, empezando por el índice del InternalDataCollectionBase especificado. (Heredado de InternalDataCollectionBase)
CopyTo(DataColumn[], Int32)	Copia toda la colección en una matriz existente, comenzando en el índice especificado de la matriz.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Obtiene un IEnumerator para la colección. (Heredado de InternalDataCollectionBase)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(DataColumn)	Obtiene el índice de una columna especificado por su nombre.
IndexOf(String)	Obtiene el índice de la columna con el nombre especificado (el nombre no distingue entre mayúsculas y minúsculas).
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(DataColumn)	Quita el objeto DataColumn especificado de la colección.
Remove(String)	Quita de la colección el objeto DataColumn que tiene el nombre especificado.
RemoveAt(Int32)	Quita la columna de la colección en el índice especificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

CollectionChanged

Se produce cuando la colección de columnas cambia, al agregar o quitar una columna.

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso. Debe sincronizar las operaciones de escritura.

Consulte también

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