Tworzenie elementu DataTable

Obiekt 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 programu .NET Framework, najczęściej jako element członkowski elementu DataSet.

Obiekt DataTable można utworzyć przy użyciu odpowiedniego konstruktora DataTable. Możesz dodać ją do zestawu DataSet przy użyciu metody Add, aby dodać ją do kolekcji Tabele obiektu DataSet.

Obiekty DataTable można również utworzyć w zestawie danych przy użyciu metod Fill lub FillSchema obiektu DataAdapter albo ze wstępnie zdefiniowanego lub wnioskowanego schematu XML przy użyciu metod ReadXml, ReadXmlSchema lub InferXmlSchema zestawu danych. Pamiętaj, że po dodaniu tabeli DataTable jako elementu członkowskiego kolekcji Tables jednego zestawu danych nie można dodać jej do kolekcji tabel dowolnego innego zestawu danych.

Podczas tworzenia tabeli DataTable nie ma schematu (czyli struktury). Aby zdefiniować schemat tabeli, należy utworzyć i dodać DataColumn obiekty do kolekcji Columns tabeli. Możesz również zdefiniować kolumnę klucza podstawowego dla tabeli i utworzyć i dodać obiekty ograniczeń do kolekcji Ograniczenia tabeli. Po zdefiniowaniu schematu dla tabeli DataTable można dodać wiersze danych do tabeli, dodając obiekty DataRow do kolekcji Wiersze tabeli.

Nie musisz podawać wartości właściwości TableName podczas tworzenia tabeli DataTable. Możesz określić właściwość w innym czasie lub pozostawić ją pustą. Jednak po dodaniu tabeli bez wartości TableName do zestawu Danych tabela będzie mieć przyrostową nazwę domyślną tabeliTable N, zaczynając od "Tabela" dla tabeli Table0.

Uwaga

Zalecamy unikanie konwencji nazewnictwa "TabelaN" podczas podawania wartości TableName , ponieważ podana nazwa może powodować konflikt z istniejącą domyślną nazwą tabeli w zestawie danych. Jeśli podana nazwa już istnieje, zostanie zgłoszony wyjątek.

Poniższy przykład tworzy wystąpienie obiektu DataTable i przypisuje mu nazwę "Customers".

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

Poniższy przykład tworzy wystąpienie elementu DataTable , dodając je do kolekcji Tables zestawu danych.

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 też