Condividi tramite

Creazione di un DataTable

Oggetto DataTable, che rappresenta una tabella di dati relazionali in memoria, può essere creata e usata in modo indipendente oppure può essere usata da altri oggetti .NET Framework, in genere come membro di un oggetto DataSet.

È possibile creare un oggetto DataTable usando il costruttore DataTable appropriato. È possibile aggiungerlo all'oggetto DataSet utilizzando il metodo Add per aggiungerlo all'insieme Tables dell'oggetto DataSet.

È anche possibile creare oggetti DataTable all'interno di un oggetto DataSet utilizzando i metodi Fill o FillSchema dell'oggetto DataAdapter oppure da uno schema XML predefinito o dedotto utilizzando i metodi ReadXml, ReadXmlSchema o InferXmlSchemadell'oggetto DataSet. Si noti che dopo aver aggiunto un oggetto DataTable come membro dell'insieme Tables di un oggetto DataSet, non è possibile aggiungerlo alla raccolta di tabelle di qualsiasi altro oggetto DataSet.

Quando si crea una tabella DataTable per la prima volta, non ha uno schema , ovvero una struttura. Per definire lo schema della tabella, è necessario creare e aggiungere DataColumn oggetti all'insieme Columns della tabella. È anche possibile definire una colonna chiave primaria per la tabella e creare e aggiungere oggetti Constraint all'insieme Constraints della tabella. Dopo aver definito lo schema per una tabella DataTable, è possibile aggiungere righe di dati alla tabella aggiungendo oggetti DataRow all'insieme Rows della tabella.

Non è necessario specificare un valore per la TableName proprietà quando si crea un oggetto DataTable. È possibile specificare la proprietà in un'altra volta oppure lasciarla vuota. Tuttavia, quando si aggiunge una tabella senza un valore TableName a un DataSet, alla tabella verrà assegnato un nome predefinito incrementale di TableN, a partire da "Table" per Table0.

Annotazioni

È consigliabile evitare la convenzione di denominazione "TableN" quando si specifica un valore TableName , perché il nome specificato potrebbe essere in conflitto con un nome di tabella predefinito esistente in DataSet. Se il nome specificato esiste già, viene generata un'eccezione.

Nell'esempio seguente viene creata un'istanza di un oggetto DataTable e viene assegnato il nome "Customers".

Dim workTable as DataTable = New DataTable("Customers")  

DataTable workTable = new DataTable("Customers");

Nell'esempio seguente viene creata un'istanza di un oggetto DataTable aggiungendola all'insieme Tables di un oggetto DataSet.

Dim customers As DataSet = New DataSet  
Dim customersTable As DataTable = _  
   customers.Tables.Add("CustomersTable")  

DataSet customers = new DataSet();  
DataTable customersTable = customers.Tables.Add("CustomersTable");

Vedere anche