DataTableCollection Clase

Definición

Representa la colección de tablas para el DataSet.Represents the collection of tables for the DataSet.

public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase
type DataTableCollection = class
    inherit InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Herencia
DataTableCollection
Atributos

Ejemplos

En el primer procedimiento de este ejemplo se recupera el DataTableCollection de una DataSet y se imprime el valor de cada columna, en cada fila, de cada tabla.The first procedure in this example retrieves the DataTableCollection of a DataSet and prints the value of each column, in each row, of each table. En el segundo procedimiento se crea un nuevo DataTable con dos columnas y se agrega a la DataTableCollection.The second procedure creates a new DataTable with two columns, and adds it to the 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

La DataTableCollection contiene todos los objetos de DataTable para un DataSetdeterminado.The DataTableCollection contains all the DataTable objects for a particular DataSet. Para tener acceso a la DataTableCollection de un DataSet, utilice la propiedad Tables.To access the DataTableCollection of a DataSet, use the Tables property.

El DataTableCollection usa métodos como Add, Cleary Remove para administrar los elementos de la colección.The DataTableCollection uses methods such as Add, Clear, and Remove to manage the items in the collection.

Utilice el método Contains para determinar si una tabla determinada (especificada por el índice o el nombre) está en la colección.Use the Contains method to determine whether a particular table (specified by either index or name) is in the collection.

Para navegar de una tabla a otra, use la propiedad ChildRelations o ParentRelations de la DataTable para tener acceso a su colección de objetos DataRelation.To navigate from one table to another, use the ChildRelations or ParentRelations property of the DataTable to access its collection of DataRelation objects. También puede utilizar la propiedad Relations para navegar por las relaciones de elementos primarios y secundarios de la DataTables en una colección de DataSet determinada.You can also use the Relations property to navigate through the parent/child relationships of the DataTables in a particular DataSet collection.

Propiedades

Count

Obtiene el número total de elementos de una colección.Gets the total number of elements in a collection.

(Heredado de InternalDataCollectionBase)
IsReadOnly

Obtiene un valor que indica si InternalDataCollectionBase es de solo lectura.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Heredado de InternalDataCollectionBase)
IsSynchronized

Obtiene un valor que indica si el objeto InternalDataCollectionBase está sincronizado.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Heredado de InternalDataCollectionBase)
Item[Int32]

Obtiene el objeto DataTable en el índice especificado.Gets the DataTable object at the specified index.

Item[String, String]

Obtiene el objeto DataTable con el nombre especificado en el espacio de nombres indicado.Gets the DataTable object with the specified name in the specified namespace.

Item[String]

Obtiene el DataTable con el nombre especificado.Gets the DataTable object with the specified name.

List

Obtiene los elementos de una colección en forma de lista.Gets the items of the collection as a list.

(Heredado de InternalDataCollectionBase)
SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar la colección.Gets an object that can be used to synchronize the collection.

(Heredado de InternalDataCollectionBase)

Métodos

Add()

Crea un nuevo objeto DataTable utilizando un nombre predeterminado y lo agrega a la colección.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable)

Agrega el DataTable especificado a la colección.Adds the specified DataTable to the collection.

Add(String)

Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String)

Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.Creates a DataTable object by using the specified name and adds it to the collection.

AddRange(DataTable[])

Copia los elementos de la matriz DataTable especificada al final de la colección.Copies the elements of the specified DataTable array to the end of the collection.

CanRemove(DataTable)

Comprueba si el objeto DataTable especificado se puede quitar de la colección.Verifies whether the specified DataTable object can be removed from the collection.

Clear()

Borra todos los objetos DataTable de la colección.Clears the collection of all DataTable objects.

Contains(String)

Obtiene un valor que indica si en la colección existe un objeto DataTable con el nombre especificado.Gets a value that indicates whether a DataTable object with the specified name exists in the collection.

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.Gets a value that indicates whether a DataTable object with the specified name and table namespace exists in the collection.

CopyTo(Array, Int32)

Copia todos los elementos del InternalDataCollectionBase actual en un Array unidimensional, empezando por el índice del InternalDataCollectionBase especificado.Copies all the elements of the current InternalDataCollectionBase to a one-dimensional Array, starting at the specified InternalDataCollectionBase index.

(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.Copies all the elements of the current DataTableCollection to a one-dimensional Array, starting at the specified destination array index.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Obtiene un IEnumerator para la colección.Gets an IEnumerator for the collection.

(Heredado de InternalDataCollectionBase)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(DataTable)

Obtiene el índice del objeto DataTable especificado.Gets the index of the specified DataTable object.

IndexOf(String)

Obtiene el índice del objeto DataTable con el nombre especificado en la colección.Gets the index in the collection of the DataTable object with the specified name.

IndexOf(String, String)

Obtiene el índice del objeto DataTable especificado en la colección.Gets the index in the collection of the specified DataTable object.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(DataTable)

Quita el objeto DataTable especificado de la colección.Removes the specified DataTable object from the collection.

Remove(String)

Quita el objeto DataTable con el nombre especificado de la colección.Removes the DataTable object with the specified name from the collection.

Remove(String, String)

Quita el objeto DataTable con el nombre especificado de la colección.Removes the DataTable object with the specified name from the collection.

RemoveAt(Int32)

Quita de la colección el objeto DataTable que está en el índice especificado.Removes the DataTable object at the specified index from the collection.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Eventos

CollectionChanged

Se produce después de que cambie la colección DataTableCollection por agregar o quitar objetos DataTable.Occurs after the DataTableCollection is changed because of DataTable objects being added or removed.

CollectionChanging

Se produce mientras cambia la colección DataTableCollection porque se están agregando o quitando objetos DataTable.Occurs while the DataTableCollection is changing because of DataTable objects being added or removed.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso.This type is safe for multithreaded read operations. Debe sincronizar cualquier operación de escritura.You must synchronize any write operations.

Consulte también: