DataTableCollection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta l'insieme di tabelle per l'oggetto 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
[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
inherit InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type DataTableCollection = class
inherit InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Public Class DataTableCollection
Inherits InternalDataCollectionBase
- Ereditarietà
- Attributi
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 all'oggetto 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
DataTableCollection Contiene 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 da index o name) si trova nell'insieme.
Per spostarsi da una tabella a un'altra, utilizzare la ChildRelations proprietà o ParentRelations di DataTable per accedere alla relativa raccolta di DataRelation oggetti. È anche possibile utilizzare la Relations proprietà per spostarsi tra le relazioni padre/figlio di DataTables in una particolare DataSet raccolta.
Proprietà
| Nome | Descrizione |
|---|---|
| Count |
Ottiene il numero totale di elementi in una raccolta. (Ereditato da InternalDataCollectionBase) |
| IsReadOnly |
Ottiene un valore che indica se l'oggetto InternalDataCollectionBase è di sola lettura. (Ereditato da InternalDataCollectionBase) |
| IsSynchronized |
Ottiene un valore che indica se l'oggetto 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 della raccolta come elenco. |
| List |
Ottiene gli elementi della raccolta come elenco. (Ereditato da InternalDataCollectionBase) |
| SyncRoot |
Ottiene un oggetto che può essere utilizzato per sincronizzare l'insieme. (Ereditato da InternalDataCollectionBase) |
Metodi
| Nome | Descrizione |
|---|---|
| Add() |
Crea un nuovo DataTable oggetto utilizzando un nome predefinito e lo aggiunge alla raccolta. |
| Add(DataTable) |
Aggiunge l'oggetto specificato |
| Add(String, String) |
Crea un DataTable oggetto utilizzando il nome specificato e lo aggiunge alla raccolta. |
| Add(String) |
Crea un DataTable oggetto utilizzando il nome specificato e lo aggiunge alla raccolta. |
| AddRange(DataTable[]) |
Copia gli elementi della matrice specificata DataTable alla fine dell'insieme. |
| CanRemove(DataTable) |
Verifica se l'oggetto specificato DataTable può essere rimosso dall'insieme. |
| Clear() |
Cancella l'insieme di tutti gli DataTable oggetti. |
| Contains(String, String) |
Ottiene un valore che indica se un DataTable oggetto con il nome e lo spazio dei nomi della tabella specificati sono presenti nell'insieme. |
| Contains(String) |
Ottiene un valore che indica se un DataTable oggetto con il nome specificato esiste nell'insieme. |
| CopyTo(Array, Int32) |
Copia tutti gli elementi dell'oggetto corrente InternalDataCollectionBase in un oggetto unidimensionale Array, a partire dall'indice specificato InternalDataCollectionBase . (Ereditato da InternalDataCollectionBase) |
| CopyTo(DataTable[], Int32) |
Copia tutti gli elementi dell'oggetto corrente DataTableCollection in un oggetto unidimensionale Array, 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 la raccolta. (Ereditato da InternalDataCollectionBase) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IndexOf(DataTable) |
Ottiene l'indice dell'oggetto specificato DataTable . |
| IndexOf(String, String) |
Ottiene l'indice nell'insieme dell'oggetto specificato DataTable . |
| IndexOf(String) |
Ottiene l'indice nell'insieme dell'oggetto DataTable con il nome specificato. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnCollectionChanged(CollectionChangeEventArgs) |
Genera l'evento OnCollectionChanged(CollectionChangeEventArgs). |
| OnCollectionChanging(CollectionChangeEventArgs) |
Rappresenta l'insieme di tabelle per l'oggetto DataSet. |
| Remove(DataTable) |
Rimuove l'oggetto specificato DataTable dall'insieme. |
| Remove(String, String) |
Rimuove l'oggetto DataTable con il nome specificato dall'insieme. |
| Remove(String) |
Rimuove l'oggetto DataTable con il nome specificato dall'insieme. |
| RemoveAt(Int32) |
Rimuove l'oggetto DataTable in corrispondenza dell'indice specificato dall'insieme. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
| Nome | Descrizione |
|---|---|
| CollectionChanged |
Si verifica dopo la modifica dell'oggetto a causa dell'aggiunta DataTableCollection o della rimozione di DataTable oggetti. |
| CollectionChanging |
Si verifica durante la modifica dell'oggetto a causa dell'aggiunta DataTableCollection o della rimozione di DataTable oggetti. |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |
Si applica a
Thread safety
Questo tipo è sicuro per le operazioni di lettura multithreading. È necessario sincronizzare tutte le operazioni di scrittura.