DataTableCollection Clase

Definición

Espacio de nombres:

System.Data

Ensamblados:

netstandard.dll, System.Data.Common.dll

Source:

DataTableCollection.cs

Representa la colección de tablas de 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 valor 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 determinado DataSet. Para acceder a DataTableCollection de , DataSetuse 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, use 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

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

Métodos

Nombre	Description
Add()	Crea un nuevo DataTable objeto mediante un nombre predeterminado y lo agrega a la colección.
Add(DataTable)	Agrega el objeto especificado DataTable a la colección.
Add(String, String)	Crea un DataTable objeto mediante el nombre especificado y lo agrega a la colección.
Add(String)	Crea un DataTable objeto mediante el nombre especificado y lo agrega a la colección.
AddRange(DataTable[])	Copia los elementos de la matriz especificada DataTable al final de la colección.
CanRemove(DataTable)	Comprueba si el objeto especificado DataTable se puede quitar de la colección.
Clear()	Borra la colección de todos los DataTable objetos.
Contains(String, String)	Obtiene un valor que indica si existe un DataTable objeto con el nombre y el espacio de nombres de tabla especificados en la colección.
Contains(String)	Obtiene un valor que indica si existe un DataTable objeto con el nombre especificado en la colección.
CopyTo(Array, Int32)	Copia todos los elementos del actual InternalDataCollectionBase en una unidimensional Array, empezando por el índice especificado InternalDataCollectionBase . (Heredado de InternalDataCollectionBase)
CopyTo(DataTable[], Int32)	Copia todos los elementos del actual DataTableCollection en una unidimensional Array, empezando por el índice de matriz de destino especificado.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetEnumerator()	Obtiene un IEnumerator para la colección. (Heredado de InternalDataCollectionBase)
GetHashCode()	Actúa como 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 especificado DataTable .
IndexOf(String, String)	Obtiene el índice de la colección del objeto especificado DataTable .
IndexOf(String)	Obtiene el índice de la colección del DataTable objeto con el nombre especificado.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Remove(DataTable)	Quita el objeto especificado DataTable de la colección.
Remove(String, String)	Quita el DataTable objeto con el nombre especificado de la colección.
Remove(String)	Quita el DataTable objeto con el nombre especificado de la colección.
RemoveAt(Int32)	Quita el DataTable objeto en el índice especificado de la colección.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

Nombre	Description
CollectionChanged	Se produce después DataTableCollection de DataTable cambiar debido a que los objetos se agregan o quitan.
CollectionChanging	Se produce mientras DataTableCollection cambia debido DataTable a que los objetos se agregan o quitan.

Métodos de extensión

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

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