CARACTERSTICAS PRINCIPALES DE LA

DATATABLECOLLECTION
Un DataSet de ADO.NET contiene una coleccin de cero o ms 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 coleccin de columnas representadas por una DataColumnCollection y
restricciones representadas por una ConstraintCollection que, juntas, definen el esquema
de la tabla. Un DataTable tambin contiene una coleccin de filas representadas por la
DataRowCollection, que contiene los datos de la tabla. Junto con su estado actual, un
DataRow conserva tanto la versin original como la actual para identificar los cambios
realizados en los valores almacenados en la fila.

Propiedades
Nombre

Descripcin

Count

Obtiene el nmero total de elementos de una coleccin. (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

coleccin. (Se hereda de InternalDataCollectionBase).

Mtodos
Nombre

Descripcin

Add()

Crea un nuevo objeto DataTable utilizando un nombre

predeterminado y lo agrega a la coleccin.

Add(DataTable)

Agrega el objeto DataTable especificado a la coleccin.

Add(String)

Crea un objeto DataTable utilizando el nombre especificado y

lo agrega a la coleccin.

Add(String, String)

Crea un objeto DataTable utilizando el nombre especificado y

lo agrega a la coleccin.

AddRange

Copia los elementos de la matriz DataTable especificada al

final de la coleccin.

CanRemove

Comprueba si el objeto DataTable especificado se puede

quitar de la coleccin.

Clear

Borra todos los objetos DataTable de la coleccin.

Contains(String)

Obtiene un valor que indica si en la coleccin existe un

objeto DataTable con el nombre especificado.

Contains(String, String)

Obtiene un valor que indica si existe en la coleccin 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

coleccin 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 coleccin. (Se hereda

de InternalDataCollectionBase).

GetHashCode

Sirve como una funcin 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 coleccin.

IndexOf(String, String)

Obtiene el ndice del objeto DataTable especificado en la

coleccin.

Remove(DataTable)

Quita de la coleccin el objeto DataTable especificado.

Remove(String)

Quita de la coleccin el objeto DataTable con el nombre

especificado.

Remove(String, String)

Quita de la coleccin el objeto DataTable con el nombre

especificado.

RemoveAt

Quita de la coleccin el objeto DataTable que est en el

ndice especificado.

ToString

Retorna una cadena que representa al objeto actual. (Se

hereda de Object).

Eventos
Nombre

Descripcin

CollectionChanged

Se produce despus de que cambie la

coleccin DataTableCollection por agregar o quitar
objetos DataTable.

CollectionChanging

Se produce mientras cambia la

coleccin DataTableCollection porque se estn agregando o
quitando objetos DataTable.

CONSIDERACIONES

La coleccin 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 mtodos como Add, Clear y Remove para
administrar los elementos de la coleccin.
Utilice el mtodo Contains para determinar si una tabla concreta (especificada
por ndice o por nombre) se encuentra en la coleccin.
Para navegar de una tabla a otra, utilice las
propiedades ChildRelations o ParentRelations de DataTable para obtener
acceso a su coleccin de objetos DataRelation. Tambin puede utilizar la
propiedad Relations para navegar en las relaciones primarias y secundarias
de las DataTables de una coleccin DataSet concreta.