Share via


Membuat DataTable

DataTable, yang mewakili satu tabel data relasional dalam memori, dapat dibuat dan digunakan secara independen, atau dapat digunakan oleh objek .NET Framework lainnya, paling umum sebagai anggota DataSet.

Anda dapat membuat objek DataTable dengan menggunakan konstruktor DataTable yang sesuai. Anda dapat menambahkannya ke Himpunan Data dengan menggunakan metode Tambahkan untuk menambahkannya ke koleksi Tabel objek Himpunan Data.

Anda juga dapat membuat objek DataTable dalam Himpunan Data dengan menggunakan metode Isi atau FillSchema objek DataAdapter, atau dari skema XML yang telah ditentukan atau disimpulkan menggunakan metode ReadXml, ReadXmlSchema, atau InferXmlSchema dari Himpunan Data. Perhatikan bahwa setelah Anda menambahkan DataTable sebagai anggota kumpulan Tabel dari satu Himpunan Data, Anda tidak dapat menambahkannya ke kumpulan tabel dari Himpunan Data lainnya.

Saat Anda pertama kali membuat DataTable, DataTable tidak memiliki skema (yaitu, struktur). Untuk menentukan skema tabel, Anda harus membuat dan menambahkan objek DataColumn ke kumpulan Kolom tabel. Anda juga dapat menentukan kolom kunci primer untuk tabel, dan membuat dan menambahkan objek Batasan ke kumpulan Batasan tabel. Setelah Anda menentukan skema untuk DataTable, Anda bisa menambahkan baris data ke tabel dengan menambahkan objek DataRow ke kumpulan Baris tabel.

Anda tidak diharuskan menyediakan nilai untuk properti TableName saat membuat DataTable; Anda dapat menentukan properti di lain waktu, atau Anda bisa membiarkannya kosong. Namun, saat Anda menambahkan tabel tanpa nilai TableName ke Himpunan Data, tabel akan diberi nama default tambahan TabelN, dimulai dengan "Tabel" untuk Table0.

Catatan

Kami menyarankan agar Anda menghindari konvensi penamaan "TabelN" saat Anda menyediakan nilai TableName, karena nama yang Anda berikan mungkin bertentangan dengan nama tabel default yang ada di Himpunan Data. Jika nama yang diberikan sudah ada, pengecualian akan ditampilkan.

Contoh berikut membuat instans objek DataTable dan menetapkannya dengan nama "Pelanggan."

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

Contoh berikut membuat instans DataTable dengan menambahkannya ke kumpulan TabelHimpunan Data.

Dim customers As DataSet = New DataSet  
Dim customersTable As DataTable = _  
   customers.Tables.Add("CustomersTable")  
DataSet customers = new DataSet();  
DataTable customersTable = customers.Tables.Add("CustomersTable");  

Lihat juga