DataTableCollection Classe

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataTableCollection.cs

Rappresenta l'insieme di tabelle per l'oggetto 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

Ereditarietà

Object

InternalDataCollectionBase

DataTableCollection

Attributi

ListBindableAttribute

Esempio

La prima routine di questo esempio recupera l'oggetto DataTableCollection di un DataSet oggetto e stampa il valore di ogni colonna, in ogni riga, di ogni tabella. La seconda routine crea un nuovo DataTable oggetto con due colonne e lo aggiunge 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

Commenti

Contiene DataTableCollection tutti gli DataTable oggetti per un particolare DataSetoggetto . Per accedere all'oggetto DataTableCollection di un DataSetoggetto , utilizzare la Tables proprietà .

DataTableCollection Usa metodi come Add, Cleare Remove per gestire gli elementi nella raccolta.

Utilizzare il Contains metodo per determinare se una determinata tabella (specificata dall'indice o dal nome) si trova nell'insieme.

Per spostarsi da una tabella a un'altra, utilizzare la ChildRelations proprietà o ParentRelations di DataTable per accedere alla raccolta di DataRelation oggetti . È anche possibile utilizzare la Relations proprietà per spostarsi tra le relazioni padre/figlio di DataTables in una raccolta specifica DataSet .

Proprietà

Count	Ottiene il numero totale di elementi in un insieme. (Ereditato da InternalDataCollectionBase)
IsReadOnly	Ottiene un valore che indica se InternalDataCollectionBase è di sola lettura. (Ereditato da InternalDataCollectionBase)
IsSynchronized	Ottiene un valore che indica se InternalDataCollectionBase è sincronizzato. (Ereditato da InternalDataCollectionBase)
Item[Int32]	Ottiene l'oggetto DataTable in corrispondenza dell'indice specificato.
Item[String, String]	Ottiene l'oggetto DataTable con il nome specificato nello spazio dei nomi specificato.
Item[String]	Ottiene l'oggetto DataTable con il nome specificato.
List	Ottiene gli elementi dell'insieme sotto forma di elenco. (Ereditato da InternalDataCollectionBase)
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'insieme. (Ereditato da InternalDataCollectionBase)

Metodi

Add()	Crea un nuovo oggetto DataTable, utilizzando un nome predefinito, e lo aggiunge all'insieme.
Add(DataTable)	Aggiunge l'oggetto DataTable specificato alla raccolta.
Add(String)	Crea un oggetto DataTable utilizzando il nome specificato e lo aggiunge all'insieme.
Add(String, String)	Crea un oggetto DataTable utilizzando il nome specificato e lo aggiunge all'insieme.
AddRange(DataTable[])	Copia gli elementi della matrice di oggetti DataTable specificata alla fine dell'insieme.
CanRemove(DataTable)	Verifica se è possibile rimuovere l'oggetto DataTable specificato dall'insieme.
Clear()	Cancella dall'insieme tutti gli oggetti DataTable.
Contains(String)	Ottiene un valore che indica se nell'insieme è presente un oggetto DataTable con il nome specificato.
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.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'insieme InternalDataCollectionBase corrente in un oggetto Array unidimensionale, partendo dall'indice di InternalDataCollectionBase specificato. (Ereditato da 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.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Ottiene un oggetto IEnumerator per l'insieme. (Ereditato da InternalDataCollectionBase)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(DataTable)	Ottiene l'indice dell'oggetto DataTable specificato.
IndexOf(String)	Ottiene l'indice dell'oggetto DataTable con il nome specificato nell'insieme.
IndexOf(String, String)	Ottiene l'indice dell'oggetto DataTable specificato nell'insieme.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(DataTable)	Rimuove l'oggetto DataTable specificato dalla raccolta.
Remove(String)	Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.
Remove(String, String)	Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.
RemoveAt(Int32)	Rimuove l'oggetto DataTable in corrispondenza dell'indice specificato dalla raccolta.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

CollectionChanged	Viene generato dopo che l'insieme DataTableCollection viene modificato in seguito all'aggiunta o alla rimozione di oggetti DataTable.
CollectionChanging	Viene generato mentre sono in corso le modifiche all'insieme DataTableCollection, a causa dell'aggiunta o della rimozione di oggetti DataTable.

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Thread safety

Questo tipo è sicuro per le operazioni di lettura multithreading. È necessario sincronizzare tutte le operazioni di scrittura.

Vedi anche

• DataColumn
• DataRow
• DataTable
• DataSet