Tworzenie elementu DataTableCreating a DataTable

A DataTable, który reprezentuje jedną tabelę danych relacyjnych w pamięci, może być tworzony i używany niezależnie lub może być używany przez inne obiekty .NET Framework, najczęściej jako element członkowski 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.

Obiekt DataTable można utworzyć przy użyciu odpowiedniego konstruktora DataTable .You can create a DataTable object by using the appropriate DataTable constructor. Możesz dodać go do zestawu danych za pomocą metody Add , aby dodać go do kolekcji tabel obiektu DataTable .You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

Można również tworzyć obiekty DataTable w ramach zestawu danych przy użyciu metod Fill lub FillSchema obiektu DataAdapter lub ze wstępnie zdefiniowanego lub wywnioskowanego schematu XML przy użyciu ReadXml, ReadXmlSchema lub InferXmlSchema metody zestawu danych.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. Należy pamiętać, że po dodaniu DataTable jako członka kolekcji tabel jednego zestawu danychnie można dodać go do kolekcji tabel innego zestawu danych.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.

Podczas pierwszej tworzenia elementu DataTablenie ma schematu (czyli struktury).When you first create a DataTable, it does not have a schema (that is, a structure). Aby zdefiniować schemat tabeli, należy utworzyć i dodać DataColumn obiekty do kolekcji kolumn tabeli.To define the schema of the table, you must create and add DataColumn objects to the Columns collection of the table. Istnieje również możliwość zdefiniowania kolumny klucza podstawowego dla tabeli oraz utworzenia i dodania obiektów ograniczeń do kolekcji ograniczenia tabeli.You can also define a primary key column for the table, and create and add Constraint objects to the Constraints collection of the table. Po zdefiniowaniu schematu dla elementu DataTablemożna dodać wiersze danych do tabeli przez dodanie obiektów DataRow do kolekcji Rows tabeli.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.

Nie trzeba podawać wartości TableName właściwości podczas tworzenia elementu DataTable; można określić właściwość w innym czasie lub pozostawić ją pustą.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. Jednak po dodaniu tabeli bez wartości TableName do zestawu danychw tabeli zostanie nadana przyrostowa domyślna nazwa tabeliN, rozpoczynając od "Tabela" dla 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.

Uwaga

Zalecamy uniknięcie konwencji nazewnictwa "TableN" w przypadku podania wartości TableName , ponieważ wprowadzona nazwa może powodować konflikt z istniejącą domyślną nazwą tabeli w zestawie danych.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. Jeśli podana nazwa już istnieje, zgłaszany jest wyjątek.If the supplied name already exists, an exception is thrown.

Poniższy przykład tworzy wystąpienie obiektu DataTable i przypisuje mu nazwę "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");  

Poniższy przykład tworzy wystąpienie elementu DataTable przez dodanie go do kolekcji Tables zestawu danych.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");  

Zobacz takżeSee also