DataTableCollection Clase

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Source:

DataTableCollection.cs

Representa la colección de tablas para el DataSet.

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

[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase

[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase

Herencia

Object

InternalDataCollectionBase

DataTableCollection

Atributos

ListBindableAttribute

Ejemplos

El primer procedimiento de este ejemplo recupera el DataTableCollection de DataSet y imprime el valor de cada columna, en cada fila, de cada tabla. El segundo procedimiento crea un nuevo DataTable con dos columnas y lo agrega a .DataTableCollection

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

Comentarios

DataTableCollection contiene todos los DataTable objetos de un objeto determinadoDataSet. Para tener acceso a DataTableCollection de , DataSetutilice la Tables propiedad .

DataTableCollection Usa métodos como Add, Cleary Remove para administrar los elementos de la colección.

Use el Contains método para determinar si una tabla determinada (especificada por índice o nombre) está en la colección.

Para navegar de una tabla a otra, utilice la ChildRelations propiedad o ParentRelations de DataTable para tener acceso a su colección de DataRelation objetos. También puede usar la Relations propiedad para navegar por las relaciones primarias o secundarias de en DataTables una colección determinada DataSet .

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 DataTable en el índice especificado.
Item[String, String]	Obtiene el objeto DataTable con el nombre especificado en el espacio de nombres indicado.
Item[String]	Obtiene el DataTable 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 un nuevo objeto DataTable utilizando un nombre predeterminado y lo agrega a la colección.
Add(DataTable)	Agrega el 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(DataTable[])	Copia los elementos de la matriz DataTable especificada al final de la colección.
CanRemove(DataTable)	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. (Heredado 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 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(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.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(DataTable)	Quita el objeto DataTable especificado de la colección.
Remove(String)	Quita el objeto DataTable con el nombre especificado de la colección.
Remove(String, String)	Quita el objeto DataTable con el nombre especificado de la colección.
RemoveAt(Int32)	Quita el objeto DataTable del índice especificado de la colección.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

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.

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

• DataColumn
• DataRow
• DataTable
• DataSet