Creazione di una DataTable (ADO.NET)
È 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, in genere come membro di un DataSet.
È possibile creare un oggetto DataTable utilizzando il costruttore DataTable appropriato. È possibile aggiungerlo al DataSet utilizzando il metodo Add per aggiungerlo alla raccolta Tables dell'oggetto DataTable.
È 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 inferito utilizzando i metodi ReadXml, ReadXmlSchema o InferXmlSchema del DataSet. Notare che dopo l'aggiunta di una DataTable come membro di una raccolta Tables di un DataSet, non sarà possibile aggiungerla a raccolte di tabelle di altri DataSet.
Una DataTable appena creata non dispone di alcuno schema, ovvero di una struttura. Per definire lo schema della tabella, è necessario creare e aggiungere oggetti DataColumn alla raccolta Columns della tabella. È inoltre possibile definire una colonna di chiavi primarie per la tabella e creare e aggiungere oggetti Constraint alla raccolta Constraints della tabella. Una volta definito lo schema per una DataTable, è possibile aggiungere righe di dati alla tabella tramite l'aggiunta di oggetti DataRow alla raccolta 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. Tuttavia, se 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.
.gif "Nota") Nota |
|---|
Si consiglia di evitare la convenzione di denominazione "ColumnN" quando si fornisce un valore per TableName, poiché è possibile che il nome fornito sia in conflitto con un nome di colonna predefinito esistente nel DataSet.Se il nome fornito è già presente, viene generata un'eccezione. |
Nell'esempio seguente viene creata un'istanza di un oggetto DataTable e viene assegnato a tale oggetto 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 aggiungendo l'oggetto alla raccolta Tables di un 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
Riferimenti
Concetti
Compilazione di un DataSet da un oggetto DataAdapter (ADO.NET)
Caricamento di un DataSet da XML (ADO.NET)
Caricamento delle informazioni relative allo schema di un DataSet da XML (ADO.NET)