Creazione di un oggetto DataTableCreating a DataTable

È possibile creare una DataTable, che rappresenta una tabella di dati relazionali in memoria, e usarla in modo indipendente oppure usarla tramite altri oggetti di .NET Framework, in genere come membro di un DataSet.A DataTable, which represents one table of in-memory relational data, can be created and used independently, or can be used by other .NET Framework objects, most commonly as a member of a DataSet.

È possibile creare un DataTable oggetto utilizzando l'oggetto appropriato DataTable costruttore.You can create a DataTable object by using the appropriate DataTable constructor. È possibile aggiungerlo al set di dati tramite il Add metodo deve essere aggiunto il DataTable dell'oggetto tabelle raccolta.You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

È anche possibile creare DataTable oggetti all'interno di un set di dati utilizzando il riempire o FillSchema metodi del DataAdapter oggetto, o da una predefinito o inferito XML schema usando il ReadXml, ReadXmlSchema, oppure InferXmlSchema i metodi del set di dati.You can also create DataTable objects within a DataSet by using the Fill or FillSchema methods of the DataAdapter object, or from a predefined or inferred XML schema using the ReadXml, ReadXmlSchema, or InferXmlSchema methods of the DataSet. Si noti che dopo aver aggiunto un DataTable come membro delle tabelle raccolta di uno set di dati, non è possibile aggiungere alla raccolta di tabelle di qualsiasi altro Set di dati.Note that after you have added a DataTable as a member of the Tables collection of one DataSet, you cannot add it to the collection of tables of any other DataSet.

Quando si crea prima di tutto una DataTable, che non è uno schema (vale a dire una struttura).When you first create a DataTable, it does not have a schema (that is, a structure). Per definire lo schema della tabella, è necessario creare e aggiungere DataColumn gli oggetti per il colonne insieme della tabella.To define the schema of the table, you must create and add DataColumn objects to the Columns collection of the table. È anche possibile definire una colonna chiave primaria per la tabella e creare e aggiungere vincolo gli oggetti per il vincoli insieme della tabella.You can also define a primary key column for the table, and create and add Constraint objects to the Constraints collection of the table. Dopo aver definito lo schema per un DataTable, è possibile aggiungere le righe di dati alla tabella tramite l'aggiunta DataRow oggetti per il righe insieme della tabella.After you have defined the schema for a DataTable, you can add rows of data to the table by adding DataRow objects to the Rows collection of the table.

Non è necessario fornire un valore per il TableName proprietà quando si crea un' DataTable; è possibile specificare la proprietà in un secondo momento, oppure è possibile lasciarla vuota.You are not required to supply a value for the TableName property when you create a DataTable; you can specify the property at another time, or you can leave it empty. Tuttavia, quando si aggiunge una tabella senza un TableName valore a un set di dati, la tabella verrà assegnato un nome predefinito incrementale TableN, che inizia con "Table" per Table0.However, when you add a table without a TableName value to a DataSet, the table will be given an incremental default name of TableN, starting with "Table" for Table0.

Nota

È consigliabile evitare il "tabellaN" convenzione di denominazione quando si fornisce un TableName valore, poiché il nome immesso sia in conflitto con un nome di tabella predefinito esistente nel set di dati .We recommend that you avoid the "TableN" naming convention when you supply a TableName value, because the name you supply may conflict with an existing default table name in the DataSet. Se il nome fornito è già presente, viene generata un'eccezione.If the supplied name already exists, an exception is thrown.

L'esempio seguente crea un'istanza di un DataTable dell'oggetto e le assegna il nome "Customers".The following example creates an instance of a DataTable object and assigns it the name "Customers."

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

L'esempio seguente crea un'istanza di un DataTable aggiungendola alle tabelle raccolta di un set di dati.The following example creates an instance of a DataTable by adding it to the Tables collection of a 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 ancheSee also