Creazione di una DataTable

È possibile creare una DataTable, che rappresenta una tabella di dati relazionali in memoria, e utilizzarla in modo indipendente oppure utilizzarla tramite altri oggetti di .NET Framework, solitamente come membro di un DataSet.

Per la creazione di un oggetto DataTable è possibile utilizzare il costruttore DataTable o passare gli argomenti del costruttore al metodo Add della proprietà Tables del DataSet, che è un DataTableCollection.

È inoltre possibile creare oggetti DataTable all'interno di un DataSet tramite i metodi Fill o FillSchema dell'oggetto DataAdapter oppure partendo da uno schema XML predefinito o dedotto utilizzando i metodi ReadXml, ReadXmlSchema o InferXmlSchema del DataSet. Si noti che dopo l'aggiunta di una DataTable come membro di un insieme Tables di un DataSet, non sarà possibile aggiungerla a insiemi di tabelle di altri DataSet.

Una DataTable appena creata non dispone di alcuno schema (struttura). Per definire lo schema della tabella, è necessario creare e aggiungere oggetti DataColumn all'insieme Columns della tabella. È inoltre possibile definire una colonna di chiavi primarie per la tabella e creare e aggiungere oggetti Constraint all'insieme Constraints della tabella. Una volta definito lo schema per una DataTable, è possibile aggiungere righe di dati alla tabella tramite l'aggiunta di oggetti DataRow all'insieme Rows della tabella.

Quando si crea una DataTable, non è necessario fornire un valore per la proprietà TableName: è possibile specificare in seguito tale proprietà o lasciarla vuota. Se tuttavia si aggiunge una tabella priva del valore TableName al DataSet, a tale tabella verrà assegnato il nome incrementale predefinito TableN, a partire da "Table" per Table0.

**Nota   **Si consiglia di evitare la convenzione di denominazione "Table" o "TableN" quando si fornisce un valore TableName, poiché è possibile che il nome fornito sia in conflitto con un nome di tabella esistente predefinito nel DataSet. Se il nome specificato esiste già, verrà generata un'eccezione.

L'esempio seguente consente di creare un'istanza di un oggetto DataTable e di assegnare a tale oggetto il nome "Customers".

Dim workTable as DataTable = New DataTable("Customers")
[C#]
DataTable workTable = new DataTable("Customers");

L'esempio seguente consente di creare un'istanza di un oggetto DataTable aggiungendolo all'insieme Tables di un DataSet.

Dim custDS As DataSet = New DataSet
Dim custTable As DataTable = custDS.Tables.Add("CustTable")
[C#]
DataSet custDS = new DataSet();
DataTable custTable = custDS.Tables.Add("CustTable");

Vedere anche

Creazione e utilizzo di DataTable | Compilazione di un DataSet da un oggetto DataAdapter | Caricamento di un DataSet da XML | Caricamento delle informazioni relative allo schema di un DataSet da XML | Classe DataTable | Classe DataTableCollection