DataTableCollection Class

Definition

Rappresenta l'insieme di tabelle per l'oggetto DataSet.Represents the collection of tables for the DataSet.

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

Examples

La prima procedura di questo esempio recupera il DataTableCollection di un DataSet e stampa il valore di ogni colonna, in ogni riga, di ogni tabella.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. La seconda procedura crea una nuova DataTable con due colonne e la aggiunge al 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

Remarks

Il DataTableCollection contiene tutti gli oggetti DataTable per un DataSetspecifico.The DataTableCollection contains all the DataTable objects for a particular DataSet. Per accedere al DataTableCollection di un DataSet, utilizzare la proprietà Tables.To access the DataTableCollection of a DataSet, use the Tables property.

Il DataTableCollection utilizza metodi quali Add, Cleare Remove per gestire gli elementi nella raccolta.The DataTableCollection uses methods such as Add, Clear, and Remove to manage the items in the collection.

Usare il metodo Contains per determinare se una determinata tabella (specificata da index o Name) è presente nella raccolta.Use the Contains method to determine whether a particular table (specified by either index or name) is in the collection.

Per spostarsi da una tabella a un'altra, utilizzare la proprietà ChildRelations o ParentRelations del DataTable per accedere alla raccolta di oggetti DataRelation.To navigate from one table to another, use the ChildRelations or ParentRelations property of the DataTable to access its collection of DataRelation objects. È anche possibile usare la proprietà Relations per spostarsi tra le relazioni padre/figlio della DataTables in una particolare raccolta di DataSet.You can also use the Relations property to navigate through the parent/child relationships of the DataTables in a particular DataSet collection.

Properties

Count

Ottiene il numero totale di elementi in un insieme.Gets the total number of elements in a collection.

(Inherited from InternalDataCollectionBase)
IsReadOnly

Ottiene un valore che indica se l'oggetto InternalDataCollectionBase è di sola lettura.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Inherited from InternalDataCollectionBase)
IsSynchronized

Ottiene un valore che indica se InternalDataCollectionBase è sincronizzato.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Inherited from InternalDataCollectionBase)
Item[Int32]

Ottiene l'oggetto DataTable in corrispondenza dell'indice specificato.Gets the DataTable object at the specified index.

Item[String, String]

Ottiene l'oggetto DataTable con il nome specificato nello spazio dei nomi specificato.Gets the DataTable object with the specified name in the specified namespace.

Item[String]

Ottiene l'oggetto DataTable con il nome specificato.Gets the DataTable object with the specified name.

List

Ottiene gli elementi dell'insieme sotto forma di elenco.Gets the items of the collection as a list.

(Inherited from InternalDataCollectionBase)
SyncRoot

Ottiene un oggetto che può essere utilizzato per sincronizzare l'insieme.Gets an object that can be used to synchronize the collection.

(Inherited from InternalDataCollectionBase)

Methods

Add()

Crea un nuovo oggetto DataTable, utilizzando un nome predefinito, e lo aggiunge all'insieme.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable)

Aggiunge l'oggetto DataTable specificato alla raccolta.Adds the specified DataTable to the collection.

Add(String)

Crea un oggetto DataTable utilizzando il nome specificato e lo aggiunge all'insieme.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String)

Crea un oggetto DataTable utilizzando il nome specificato e lo aggiunge all'insieme.Creates a DataTable object by using the specified name and adds it to the collection.

AddRange(DataTable[])

Copia gli elementi della matrice di oggetti DataTable specificata alla fine dell'insieme.Copies the elements of the specified DataTable array to the end of the collection.

CanRemove(DataTable)

Verifica se è possibile rimuovere l'oggetto DataTable specificato dall'insieme.Verifies whether the specified DataTable object can be removed from the collection.

Clear()

Cancella dall'insieme tutti gli oggetti DataTable.Clears the collection of all DataTable objects.

Contains(String)

Ottiene un valore che indica se nell'insieme è presente un oggetto DataTable con il nome specificato.Gets a value that indicates whether a DataTable object with the specified name exists in the collection.

Contains(String, String)

Ottiene un valore che indica se nell'insieme è presente un oggetto DataTable con il nome specificato e lo spazio dei nomi della tabella.Gets a value that indicates whether a DataTable object with the specified name and table namespace exists in the collection.

CopyTo(Array, Int32)

Copia tutti gli elementi dell'insieme InternalDataCollectionBase corrente in un oggetto Array unidimensionale, partendo dall'indice di InternalDataCollectionBase specificato.Copies all the elements of the current InternalDataCollectionBase to a one-dimensional Array, starting at the specified InternalDataCollectionBase index.

(Inherited from InternalDataCollectionBase)
CopyTo(DataTable[], Int32)

Copia tutti gli elementi dell'insieme DataTableCollection corrente in un oggetto Array unidimensionale, a partire dall'indice della matrice di destinazione specificato.Copies all the elements of the current DataTableCollection to a one-dimensional Array, starting at the specified destination array index.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator()

Ottiene un oggetto IEnumerator per l'insieme.Gets an IEnumerator for the collection.

(Inherited from InternalDataCollectionBase)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(DataTable)

Ottiene l'indice dell'oggetto DataTable specificato.Gets the index of the specified DataTable object.

IndexOf(String)

Ottiene l'indice dell'oggetto DataTable con il nome specificato nell'insieme.Gets the index in the collection of the DataTable object with the specified name.

IndexOf(String, String)

Ottiene l'indice dell'oggetto DataTable specificato nell'insieme.Gets the index in the collection of the specified DataTable object.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(DataTable)

Rimuove l'oggetto DataTable specificato dalla raccolta.Removes the specified DataTable object from the collection.

Remove(String)

Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.Removes the DataTable object with the specified name from the collection.

Remove(String, String)

Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.Removes the DataTable object with the specified name from the collection.

RemoveAt(Int32)

Rimuove l'oggetto DataTable in corrispondenza dell'indice specificato dalla raccolta.Removes the DataTable object at the specified index from the collection.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Events

CollectionChanged

Viene generato dopo che l'insieme DataTableCollection viene modificato in seguito all'aggiunta o alla rimozione di oggetti DataTable.Occurs after the DataTableCollection is changed because of DataTable objects being added or removed.

CollectionChanging

Viene generato mentre sono in corso le modifiche all'insieme DataTableCollection, a causa dell'aggiunta o della rimozione di oggetti DataTable.Occurs while the DataTableCollection is changing because of DataTable objects being added or removed.

Extension Methods

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Applies to

Thread Safety

Questo tipo è sicuro per le operazioni di lettura multithread.This type is safe for multithreaded read operations. È necessario sincronizzare le operazioni di scrittura.You must synchronize any write operations.

See also