Udostępnij przez

Tworzenie tabeli 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.

Utworzyć obiekt DataTable można przy użyciu odpowiedniego DataTable konstruktora. Możesz dodać to do DataSet przy użyciu metody Add, aby dodać to do kolekcji Tables obiektu DataSet.

Również można stworzyć obiekty w obiekcie przy użyciu metod lub obiektu , albo z wstępnie zdefiniowanego lub wnioskowanego schematu XML, używając metod ReadXml, ReadXmlSchema lub zestawu danych . Należy pamiętać, że po dodaniu DataTable elementu członkowskiego kolekcji Tables jednego zestawu danych nie można dodać go 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 Columns kolekcji tabeli. Możesz również zdefiniować kolumnę klucza podstawowego dla tabeli i utworzyć i dodać Constraint obiekty do Constraints kolekcji tabeli. Po zdefiniowaniu schematu dla tabeli DataTable można dodać do tabeli wiersze danych, dodając DataRow obiekty do Rows kolekcji 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 w przypadku dodawania tabeli bez TableName wartości do zestawu danych tabela będzie mieć przyrostową nazwę domyślną tabeliN, zaczynając od wartości "Tabela" dla tabeli Table0.

Uwaga / Notatka

Zalecamy unikanie konwencji nazewnictwa "TabelaN" podczas podawania TableName wartości, 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 DataTable obiektu i przypisuje mu nazwę "Klienci".

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

DataTable workTable = new DataTable("Customers");

Poniższy przykład tworzy wystąpienie obiektu DataTable przez dodanie go do Tables kolekcji 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 także

  • Last updated on