Kontrol AccessDataSource di ASP.NET2.0

Penulis：Eve Cole Waktu Pembaruan：2009-06-30 16:37:44

ASP.NET 2.0 menyertakan kontrol AccessDataSource, yang digunakan untuk mengekstrak data dari database Access ke halaman ASP.NET 2.0 (.aspx). Properti yang dimiliki kontrol ini sangat sederhana. Atribut terpenting dari AccessDataSource adalah atribut DataFile, yang digunakan untuk menunjuk ke jalur file MDB di hard disk. Properti lain yang dimiliki oleh AccessDataSource mencakup SelectCommand, yang digunakan untuk mengatur pernyataan yang menampilkan kumpulan hasil (tabel dan kolom) yang perlu dikembalikan. SelectCommand harus didefinisikan menggunakan sintaks SQL.

Di VWD, ada dua cara untuk menambahkan kontrol AccessDataSource ke halaman. Jika file MDB ditambahkan ke Database Explorer seperti pada contoh sebelumnya, nama kolom dapat diseret dan dijatuhkan ke halaman, dan VWD secara otomatis akan membuat kontrol AccessDataSource dan GridViews untuk menampilkan data. Jika Anda tidak ingin menggunakan GridView atau ingin mengkustomisasi kontrol, Anda cukup menambahkan kontrol AccessDataSource dari kotak alat dan menginstalnya melalui wizard konfigurasi. Wizard akan meminta Anda untuk menelusuri file data dan memungkinkan Anda menentukan SelectCommand dengan memilih kolom dalam tabel database. Jika Anda masuk ke halaman di luar VWD, Anda dapat memasukkannya sebagai berikut:

<asp:AccessDataSource>
ID="NamaSumber Saya"
Runat="server"
DataFile="NamaMDB Saya.mdb"
SelectCommand="PILIH Bidang Saya1, Bidang Saya2 DARI Tabel Saya">
＜/asp:AccessDataSource＞

Fitur yang perlu disebutkan lagi sederhana saja. Yang perlu Anda berikan hanyalah ID, nama file MDB, dan SelectCommand.

Artikel ini membahas tentang kontrol sumber data, namun perlu diingat bahwa kontrol sumber data tidak membuat apa pun terlihat di halaman. Jadi untuk memberi Anda cara visual menguji kontrol sumber data, "Cobalah" berikutnya akan mencakup langkah-langkah dasar menggunakan kontrol GridView (berevolusi dari kontrol DataGrid versi ASP.NET 1) untuk menampilkan data dalam tabel. Harap dicatat bahwa fokus bab ini bukan pada konfigurasi dan penyesuaian GridView; dalam hal ini, fokusnya adalah pada kontrol sumber data. Nanti di Bab 5, kontrol GridView akan dipelajari lebih detail.

Coba #2 - Hubungkan ke MDB dan tampilkan data dengan GridView

Pada contoh artikel ini, informasi produk yang telah terjual akan ditampilkan melalui Northwind pada halaman tersebut.

(1) Mulai editor halaman dan ramban ke C:WebsitesBegAspNet2Dbch02.

(2) Tambahkan halaman bernama TIO-ch02-2-DisplayAccessData dari templat Formulir Web. Klik label di bawah untuk beralih ke tampilan Desain.

(3) Di bagian atas halaman, masukkan judul seperti "Demo menghubungkan ke sumber data MDB" dan tuliskan teks yang sama di judul halaman. Meskipun langkah ini tidak dibahas dalam setiap latihan, kami menyarankan untuk menyertakan judul dan teks HTML pada setiap halaman agar halaman yang sedang Anda lihat tidak hilang.

<html>
＜kepala＞
＜title＞TIO ch02-1 Menampilkan Data MDB＜/title＞
＜kepala＞
<tubuh>
＜h3＞ch02 TIO 2 Demonstrasi koneksi ke sumber MDB ＜/h3＞
<tubuh>
＜/html＞

(4) Tampilkan kotak alat (Menu: Lihat|kotak alat atau ketik Ctrl+Alt+X) dan perluas panel Data pada kotak alat.

(5) Seret kontrol AccessDataSource ke halaman.

(6) Panel tugas kontrol yang mudah digunakan akan muncul secara otomatis. Jika panel tidak muncul secara otomatis, Anda dapat memilih sumber data baru dan klik panah kecil di kanan atas untuk membuka panel tugas yang mudah digunakan. Klik Konfigurasikan Sumber Data.

(7) Pada langkah Pilih Database, klik tombol Telusuri dan pilih C:WebsitesBegAspNet 2DbApp_DataNorthwind.mdb, dan perhatikan bahwa perancang mengubah deskripsi file menjadi referensi relatif, yaitu menggunakan simbol (~) untuk mewakili situs direktori root.

(8) Dalam kotak dialog Konfigurasikan Pernyataan Pilihan, pilih opsi Tentukan Kolom dan pilih tabel Produk. Klik tanda bintang untuk memilih semua kolom. Klik Berikutnya, Uji Kueri, dan Selesai.

(9) Pilih kontrol Data dan tampilkan jendela Properties dengan menekan F4. Ubah ID-nya menjadi NorthwindProducts.

(10) Kembali ke panel Data pada kotak alat, klik dua kali pada GridView untuk menambahkan kontrol ke halaman dan masuk ke Menu Tugas Umum, lalu klik Pilih Sumber Data. Pilih NorthwindProducts dan akhiri wizard.

(11) Pilih GridView dan ubah ID-nya menjadi NorthwindProducts. Halamannya akan terlihat seperti ini:

＜%@ halaman bahasa="VB" %＞
<html>
＜head＞＜title＞ch02 TIO 2 Menampilkan Data MDB＜/title＞＜/head＞
<tubuh>
＜h3＞ch02 TIO 2 Demonstrasi Koneksi ke Sumber MDB ＜/h3＞
＜form runat="server"＞
<asp:accessdatasource id="NorthwindProductsAccDataSource" runat="server"
selectcommand="Pilih * Dari Produk"
datafile="~/App_Data/Northwind.mdb">
＜/asp:accessdatasource＞
<asp:gridview id="NorthwindProductsGridView" runat="server"
datasourceid="NorthwindProductsAccDataSource">
＜/asp:tampilan grid＞
＜/form＞＜/body＞＜/html＞

(12) Buka browser dan lihat C:WebsitesBegAspNet2Dbch02ch02_TIO_2_DisplayAccessData.aspx (lihat Gambar 2-2).

Gambar 2-2

(13) Operasi terakhir adalah menampilkan data dari MDB Query, bukan tabel. Tutup browser dan kembali ke VWD. Simpan file dengan nama baru ch02_TIO_2_DisplayAccessData-Query.aspx. Pilih GridView dan buka Common Task Menu dengan mengklik panah kecil di sudut kanan atas kontrol. Klik Konfigurasikan Sumber Data dan Berikutnya untuk melewati pemilihan file MDB. Pada antarmuka Konfigurasikan Pernyataan Pilihan, ubah nama menjadi "Klasifikasi Penjualan" dan klik tanda bintang untuk mendapatkan semua bidang. Kueri ini menggabungkan empat tabel bersama-sama menggunakan GABUNG, membatasi jumlah catatan yang digunakan dalam sebuah tabel dan melakukan beberapa operasi pengelompokan dan agregasi pada data untuk mendapatkan totalnya. Klik Berikutnya, Uji Kueri, dan Selesai. Kontrol sumber data akan terlihat seperti ini:

<asp:accessdatasource id="NorthwindProductsAccDataSource" runat="server"
selectcommand="Pilih * Dari [Penjualan berdasarkan Kategori] "
Datafile="~/App_Data/Northwind.mdb">
＜/asp:accessdatasource＞

(14) Buka browser dan lihat halamannya.

Contoh Catatan #2 - Hubungkan ke MDB dan tampilkan data dengan GridView

Anda memiliki dua kontrol di halaman. Yang pertama, AccessDataSource, melakukan semua pekerjaan menyambung ke objek ADO.NET yang terhubung ke mesin JET yang berinteraksi dengan file MDB. Yang kedua adalah GridView yang digunakan untuk memperoleh data dan mengubah formatnya menjadi format HTML yang dapat ditampilkan pada halaman. Harap dicatat bahwa sangat penting untuk memberi setiap kontrol nama (ID) yang bermakna. Anda kemudian harus memastikan bahwa kontrol terikat data (GridView) menggunakan properti DataSourceID untuk mereferensikan ID AccessDataSource agar dapat menggunakan AccessDataSource sebagai sumber datanya.

Menampilkan data dari kueri tidak terlalu sulit; di Access Anda bisa menggunakan nama kueri, bukan nama tabel. Ada dua instruksi di sini. Pertama, jika ada spasi pada nama tabel atau query, seluruh nama harus diapit tanda kurung siku. Kedua, pertanyaan yang memerlukan masukan pengguna (misalnya, "penjualan pada tahun tertentu" memerlukan mengetahui tahun berapa) melibatkan teknik yang berada di luar cakupan buku ini.

Setelah menyelesaikan langkah sebelumnya, Anda bisa melihat data yang diperoleh dari kontrol AccessDataSource ditampilkan di halaman. Bab selanjutnya akan membahas GridView secara detail, namun bab ini akan terus fokus pada kontrol sumber data.

Pilih variabel dalam pernyataan

Saat membuat sumber data di VWD, wizard akan meminta Anda menentukan kolom yang perlu ditampilkan atau membuat pernyataan SQL kustom. Pada "Try It Away" sebelumnya, Anda cukup memilih beberapa kolom. Pernyataan SQL yang lebih kompleks dapat ditentukan dalam beberapa cara berbeda:

● Gunakan kotak dialog interaktif

● Masukkan pernyataan SQL yang disesuaikan di wizard AccessDataSource (disebut dengan tugas praktis Konfigurasi Sumber Data di kontrol)

● Masukkan pernyataan dalam kotak properti

● Masukkan pernyataan secara langsung pada markup tampilan Sumber

Memilih kolom di panduan Access DataSource adalah teknik pilihan untuk kueri sederhana yang mengembalikan satu atau beberapa kolom dari tabel terpisah karena mengurangi kesalahan tipografi dan sintaksis (lihat Gambar 2-3). Dalam wizard ini, Anda bisa memilih nama tabel atau kueri dari daftar drop-down Nama. Anda kemudian dapat memilih kolom yang diperlukan dalam tabel atau kueri dengan memilih semua kolom (*) atau grup kolom mana pun. Jika Anda mengklik tombol Urutkan Berdasarkan, Anda dapat mengurutkan berdasarkan kolom mana pun di sumber data. Jika ada batasan pada kolom pertama, kolom yang dipilih di Then By akan digunakan. Saat Anda memilih opsi dari wizard, perhatikan bahwa sintaks SQL sebenarnya untuk SelectCommand juga ditampilkan dalam kotak teks baca-saja.

Gambar 2-3

Anda dapat menggunakan tombol WHERE di wizard untuk membuat pernyataan SQL dengan parameter. Kami akan melewatkan pilihan ini untuk saat ini, namun penting bahwa sebelum penerapan Anda menggunakan parameter ini yang akan dibahas nanti dalam buku ini. Di situs yang disebarkan, hindari menghubungkan input pengguna secara langsung ke pernyataan SQL. Mengabaikan masalah parameter akan membuat situs Anda terkena serangan injeksi SQL. Teknik serangan ini menggunakan karakter palsu dari input pengguna untuk membatalkan pernyataan SQL asli dan kemudian menggantinya dengan pernyataan destruktif. Anda dapat menggunakan koleksi parameter untuk mengirim input pengguna ke koleksi parameter ADO.NET, yang dapat menggunakan fungsionalitas koleksi untuk mengurangi masalah injeksi SQL.

Meskipun wizard Konfigurasi Sumber Data memiliki banyak opsi untuk membantu membuat pernyataan SQL dengan cepat, terkadang Anda masih perlu memasukkan (atau memodifikasi) pernyataan SQL secara langsung di SelectCommand yang ditandai. Wizard AccessDataSource mengizinkan operasi ini. Di halaman panduan untuk memilih tabel, kueri, dan kolom, Anda dapat memilih tombol radio untuk "Tentukan pernyataan SQL kustom atau prosedur tersimpan." Setelah memilih opsi ini di halaman wizard, klik tombol Berikutnya untuk masuk ke halaman lain di mana Anda dapat langsung memasukkan pernyataan khusus di area teks. Anda juga bisa menggunakan Visual Studio QueryBuilder untuk membuat pernyataan kustom secara visual, menggunakan alat yang sangat mirip dengan Access QueryBuilder.

Jika Anda tidak ingin menggunakan panduan, Anda bisa memilih untuk memasukkan pernyataan SQL kustom di kisi properti kontrol AccessDataSource, atau Anda bisa beralih ke tampilan Sumber dan memasukkan pernyataan di properti SelectCommand dari tag kontrol AccessDataSource.

Ada banyak buku tentang SQL (jenis yang sama dengan ini adalah Pemrograman SQL Awal , ISBN 1-861001-80-0), dan buku ini memberikan pengantar singkat di lampiran. Jika Anda berencana mempelajari sintaksis SQL, Anda bisa memulai dengan mempelajari perintah untuk mengembalikan bagian dari sebuah record (TOP dan DISTINCT), sintaks untuk mengganti nama field (AS), dan teknik untuk mengembalikan field dari dua tabel terkait (JOIN) . Latihan berikut akan mengeksplorasi beberapa variabel dalam pernyataan SQL.

Coba #3 - Mengubah Pernyataan Select di AccessDataSource Dalam latihan ini, Anda akan menampilkan kolom tertentu dan catatan tertentu dari tabel Produk Northwind. Sebuah halaman juga akan dibuat untuk menampilkan data yang diperoleh dari query. Harap dicatat bahwa dalam latihan ini, aturan pemilihan sudah ada dalam kode sumber. Saat ini, tidak ada masukan pengguna sebagai opsi.

(1) Buat file bernama ch02_TIO_3_AlternateSelect-Commands.aspx di C:WebsitesBegAspNet2Dbch02.

(2) Tambahkan kontrol AccessDataSource dengan Northwind sebagai ID dan atur MDB ke App_DataNorthwind.mdb. Dalam serangkaian kotak dialog, atur perintah Pilih untuk mengambil semua bidang dari tabel Produk ("nama"=Produk). Lihatlah tampilan Sumber dan perhatikan pernyataan yang Anda buat, seperti yang ditunjukkan di bawah ini:

PILIH * DARI Produk

(3) Tambahkan GridView, atur ID ke Northwind, dan atur sumber data ke Northwind. Berikut tampilan keseluruhan halaman sejauh ini:

＜%@ halaman bahasa="VB" %＞
<html>
＜head runat="server"＞
＜title＞ch02 TIO 3 Pilihan Alternatif Conimands＜/title＞
＜/kepala＞
<tubuh>
＜h3＞ch02 TIO 3 Perintah Pilihan Alternatif＜/h3＞
＜form runat="server"＞
<asp:accessdatasource id="NorthwindAccDataSource" runat="server"
selectcommand="PILIH * DARI Produk"
datafile=" ~/App_Data/Northwind.mdb" >
＜/asp:accessdatasource＞
<asp:gridview id="GridViewl" runat="server"
datasourceid="NorthwindAccDataSource">
＜/asp:tampilan grid＞
＜/bentuk＞
＜/badan＞
＜/html＞

(4) Sekarang buka halaman di browser dan perhatikan antarmuka yang ditunjukkan pada Gambar 2-4 (tidak semua kolom ditampilkan pada tangkapan layar).

Gambar 2-4

(5) Kembali ke tampilan Desain dan pilih AccessDataSource (bukan GridView). Buka panel tugasnya yang praktis dan klik Konfigurasikan Sumber Data. Di jendela Konfigurasikan Pernyataan Pilihan, pilih "Tentukan pernyataan SQL khusus" dan klik Berikutnya. Ubah pernyataan SQL di editor sebagai berikut:

PILIH * DARI [Produk] DIMANA (ID Kategori=3)

(6) Klik Berikutnya dan uji kueri. Klik OK untuk menutup kotak dialog. Lihatlah halaman dalam tampilan Sumber dan perhatikan kode berikut:

<asp:accessdatasource id="NorthwindAccDataSource" runat="server"
selectcommand="PILIH * DARI [Produk] DI MANA (ID Kategori = 3) "
Datafile="~App_Data/Northwind.mdb">
＜/asp:accessdatasource＞

(7) Coba gunakan kotak dialog untuk membuat beberapa perintah Pilih berikut. Anda juga dapat memasukkannya dalam tampilan Sumber, atau menggunakan kombinasi keduanya.

PILIH * DARI Produk DIMANA ProductID = 12
PILIH * DARI Produk WHERE ProductName = 'Northwoods Cranberry Sauce'
PILIH * DARI Produk DIMANA ProductID <11
PILIH * DARI Produk DIMANA ProductID <11 ORDER BERDASARKAN Nama Produk Menaik
PILIH * DARI Produk DIMANA SupplierID = 6 ATAU SupplierID = 8
PILIH * DARI Produk DIMANA SupplierID = 24 DAN Harga Satuan ＞ 10

Contoh Catatan #3 - Mengubah Pernyataan Select di AccessDataSource

Dalam beberapa langkah pertama, buat kontrol AccessDataSource dan GridView seperti sebelumnya. Tapi kemudian saya mulai bereksperimen dengan pernyataan Select. Menambah dan menghapus kolom melalui kotak centang adalah yang paling intuitif. Anda juga dapat langsung memasukkan (atau mengedit) pernyataan SQL di jendela editor.

Klausa WHERE telah ditambahkan untuk membatasi catatan yang dikembalikan dari file MDB. Jika nama kolom tidak mengandung spasi, tanda kurung siku dapat dihilangkan. Tanda kurung siku ini harus digunakan jika nama kolom mengandung spasi.

Variabel dalam lokasi file MDB

File MDB disimpan di berbagai lokasi fisik pada hard disk: folder yang sama dengan halaman Web, subfolder di bawah halaman Web, atau folder lain di mesin, dll. Di Visual Web Developer, file-file ini dapat sering dijelajahi di desainer, dan jalur yang benar ke file MDB telah dimasukkan. Namun, jika Anda berencana memasukkan kode Anda sendiri, Anda harus mengikuti sintaks yang dijelaskan di bagian ini.

Properti DataFile dari kontrol AccessDataSource berisi jalur halaman yang dapat sepenuhnya memenuhi syarat (misalnya, dimulai dengan huruf kandar) atau ditentukan relatif terhadap lokasi halaman yang berisi AccessDataSource. Jalur juga bisa bersifat relatif terhadap aplikasi, yaitu menggunakan sintaks URL untuk mereferensikan jalur tersebut. Sintaks ini menggantikan simbol (~) dengan direktori root aplikasi, misalnya: ~App_Dataproduces.mdb. Penggunaan jalur relatif aplikasi mempermudah perpindahan halaman dari satu lokasi ke lokasi lain tanpa merusak referensi ke database, sehingga disarankan untuk menggunakan jalur relatif aplikasi bila memungkinkan.

Pertama, mari kita lihat sintaks jalur yang sepenuhnya memenuhi syarat, yang berisi seluruh jalur ke file MDB, dimulai dari akar drive komputer tempat file tersebut berada:

<asp:aksesdatasource .

datafile= "C:WebSitesWebApplicationApp_DataMyMdb.mdb">

Meskipun sintaks ini dapat digunakan, namun kelemahannya adalah mengurangi portabilitas aplikasi. Jika Anda memindahkan aplikasi ke komputer lain, jalur yang sepenuhnya memenuhi syarat ke drive atau file akan berbeda, dan Anda perlu mengubah properti DataFile setiap kali Anda memindahkan halaman.

Peningkatan terhadap jalur yang sepenuhnya memenuhi syarat adalah dengan menggunakan sintaksis jalur relatif, yang hanya memerlukan penentuan bagian jalur yang sepenuhnya memenuhi syarat yang berbeda dari halaman yang berisi AccessDataSource. Berikut ini adalah sintaks jalur untuk file database di folder yang sama dengan halaman, yang ditentukan sebagai jalur relatif:

<asp:aksesdatasumber . .datafile="MyMdb.mdb">

Karena halaman dan file MDB berada di direktori yang sama, tidak ada perbedaan jalur file-file ini, oleh karena itu, Anda hanya perlu menentukan nama file masing-masing; Jika MDB berada di satu atau lebih direktori di bawah folder, sintaks berikut ini sangat mirip dengan yang sebelumnya. Dalam hal ini, cukup tentukan nama subfolder, diikuti dengan garis miring dan nama file MDF:

<asp:accessdatasource . .datafile="MyDaughterFolder/MyMdb.mdb">

Jika file MDB berada di direktori tingkat atas dari direktori halaman, Anda juga dapat menggunakan sintaks titik ganda untuk menentukan direktori tingkat atas dari lokasi saat ini:

<asp:aksesdatasumber . .datafile="../MyMdb.mdb">

Dengan menggunakan sintaks jalur relatif, Anda dapat dengan mudah memindahkan aplikasi dari satu tempat ke tempat lain tanpa mengubah jalur file MDB. Karena halaman dan file MDB selalu tidak dapat dipisahkan (jika file MDB adalah bagian dari aplikasi), posisi relatif dari file-file ini selalu tetap konsisten. Namun apa jadinya bila Anda ingin memindahkan jalur dalam aplikasi, misalnya memindahkan halaman ke subdirektori? Dalam kasus ini, posisi relatif antara halaman dan berkas MDB telah berubah, dan sintaks jalur relatif salah.

Sintaks relatif aplikasi memecahkan masalah ini. Dalam hal ini, jalur selalu ditentukan relatif terhadap direktori root aplikasi, bukan terhadap halaman itu sendiri. Direktori root diwakili oleh simbol (~):

<asp:accessdatasource . .datafile="~App_Data/MyMdb.mdb>

Sekarang Anda dapat dengan mudah memindahkan aplikasi Anda, atau memindahkan halaman dalam aplikasi Anda, tanpa mengubah referensi ke database. Oleh karena itu, jalur relatif aplikasi harus digunakan bila memungkinkan.