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 i DataTable costruttore.You can create a DataTable object by using the appropriate DataTable constructor. È possibile aggiungerlo al DataSet utilizzando il Aggiungi metodo per aggiungerlo al DataTable dell'oggetto tabelle insieme.You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

È inoltre possibile creare DataTable oggetti all'interno di un set di dati utilizzando il riempimento o FillSchema metodi del DataAdapter oggetto, o da un predefinito o inferito uno schema XML utilizzando il ReadXml, ReadXmlSchema, o InferXmlSchema metodi di DataSet.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 del tabelle raccolta costituita da un DataSet, non è possibile aggiungere alla raccolta di tabelle di qualsiasi altro DataSet.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 innanzitutto un DataTable, non è uno schema (ovvero, 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 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. È inoltre possibile definire una colonna chiave primaria per la tabella e creare e aggiungere vincolo 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 righe di dati alla tabella aggiungendo 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 lasciare vuoto.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 un DataSet, 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 di "tabellaN" convenzione di denominazione quando si fornisce un TableName valore, poiché il nome 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 viene assegnato 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 aggiungendolo al tabelle raccolta di un DataSet.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

DataTable
DataTableCollection
DataTableDataTables
Popolamento di un set di dati da un oggetto DataAdapterPopulating a DataSet from a DataAdapter
Caricamento di un oggetto DataSet da XMLLoading a DataSet from XML
Caricamento delle informazioni dello schema DataSet da XMLLoading DataSet Schema Information from XML
Provider gestiti ADO.NET e Centro per sviluppatori di set di datiADO.NET Managed Providers and DataSet Developer Center