CARACTERÍSTICAS PRINCIPALES DE LA DATATABLECOLLECTION

Un DataSet de ADO.NET contiene una colección de cero o más tablas representadas por objetos DataTable.

La DataTableCollection contiene todos los objetos DataTable de un DataSet.

Un DataTable se define en el espacio de nombres System.Data y representa una única tabla de datos residentes en memoria.

Contiene una colección de columnas representadas por una DataColumnCollection y restricciones representadas por una ConstraintCollection que, juntas, definen el esquema de la tabla. Un DataTable también contiene una colección de filas representadas por la DataRowCollection, que contiene los datos de la tabla. Junto con su estado actual, un DataRow conserva tanto la versión original como la actual para identificar los cambios realizados en los valores almacenados en la fila.

Propiedades

Nombre Descripción

Count Obtiene el número total de elementos de una colección. (Se hereda de InternalDataCollectionBase).

IsReadOnly Obtiene un valor que indica si InternalDataCollectionBase es de solo lectura. (Se hereda de InternalDataCollectionBase).

IsSynchronized Obtiene un valor que indica si el objeto InternalDataCollectionBase está sincronizado. (Se hereda de InternalDataCollectionBase).

Item[Int32] Obtiene el objeto DataTable en el índice especificado.

Item[String] Obtiene el DataTable con el nombre especificado.

Item[String, String]

Obtiene el objeto DataTable con el nombre especificado en el espacio de nombres indicado.

SyncRoot Obtiene un objeto que se puede utilizar para sincronizar la colección. (Se hereda de InternalDataCollectionBase).

Métodos

Nombre Descripción

Add() Crea un nuevo objeto DataTable utilizando un nombre predeterminado y lo agrega a la colección.

Add(DataTable) Agrega el objeto DataTable especificado a la colección.

Add(String) Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.

Add(String, String) Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.

AddRange Copia los elementos de la matriz DataTable especificada al final de la colección.

CanRemove Comprueba si el objeto DataTable especificado se puede quitar de la colección.

Clear Borra todos los objetos DataTable de la colección.

Contains(String) Obtiene un valor que indica si en la colección existe un objeto DataTable con el nombre especificado.

Contains(String, String) Obtiene un valor que indica si existe en la colección un objeto DataTable con el nombre y espacio de nombres de tabla especificados.

CopyTo(Array, Int32) Copia todos los elementos del InternalDataCollectionBase actual en un Array unidimensional, empezando por el índice del InternalDataCollectionBase especificado. (Se hereda de InternalDataCollectionBase).

CopyTo(DataTable[], Int32)

Copia todos los elementos de la colección DataTableCollection actual en una matriz Array unidimensional, empezando por el índice especificado de la matriz de destino.

Equals(Object) Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).

GetEnumerator Obtiene un IEnumerator para la colección. (Se hereda de InternalDataCollectionBase).

GetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).

GetType Obtiene el Typede la instancia actual. (Se hereda de Object).

IndexOf(DataTable) Obtiene el índice del objeto DataTable especificado.

IndexOf(String) Obtiene el índice del objeto DataTable con el nombre especificado en la colección.

IndexOf(String, String) Obtiene el índice del objeto DataTable especificado en la colección.

Remove(DataTable) Quita de la colección el objeto DataTable especificado.

Remove(String) Quita de la colección el objeto DataTable con el nombre especificado.

Remove(String, String) Quita de la colección el objeto DataTable con el nombre especificado.

RemoveAt Quita de la colección el objeto DataTable que está en el índice especificado.

ToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).

Eventos

Nombre Descripción

CollectionChanged Se produce después de que cambie la colección DataTableCollection por agregar o quitar objetos DataTable.

CollectionChanging Se produce mientras cambia la colección DataTableCollection porque se están agregando o quitando objetos DataTable.

CONSIDERACIONES La colección DataTableCollection contiene todos los objetos DataTable para un

objeto DataSet concreto. Para obtener acceso a DataTableCollection de un DataSet, utilice la propiedad Tables.

DataTableCollection utiliza métodos como Add, Clear y Remove para administrar los elementos de la colección.

Utilice el método Contains para determinar si una tabla concreta (especificada por índice o por nombre) se encuentra en la colección.

Para navegar de una tabla a otra, utilice las propiedades “ChildRelations” o “ParentRelations” de DataTable para obtener acceso a su colección de objetos DataRelation. También puede utilizar la propiedad “Relations” para navegar en las relaciones primarias y secundarias de las DataTables de una colección DataSet concreta.