Fungsi DLookup

Berlaku Untuk
Access untuk Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Dalam database desktop Access, Anda dapat menggunakan fungsi ini DLookup untuk mendapatkan nilai bidang tertentu dari kumpulan rekaman tertentu (domain). Anda dapat menggunakannya DLookup dalam modul Visual Basic for Applications (VBA), makro, ekspresi kueri, atau kontrol terhitung pada formulir atau laporan.

Anda dapat menggunakan fungsi ini DLookup untuk menampilkan nilai bidang yang tidak ada dalam sumber catatan untuk formulir atau laporan Anda. Sebagai contoh, misalkan Anda memiliki formulir berdasarkan tabel Detail Pesanan. Formulir menampilkan OrderIDbidang , ProductID, UnitPrice, Quantity, dan Discount . Namun, bidang tersebut ProductName ada di tabel lain, tabel Products . Anda dapat menggunakan fungsi dalam DLookup kontrol terhitung untuk ditampilkan ProductName pada formulir yang sama.

Sintaks

DLookup(expr, domain [, criteria])

Fungsi ini DLookup memiliki argumen berikut:

Argumen Deskripsi
expr Diperlukan. Ekspresi yang mengidentifikasi bidang yang nilai yang hasilnya ingin Anda dapatkan. Ini dapat berupa ekspresi string yang mengidentifikasi bidang dalam tabel atau kueri, atau dapat berupa ekspresi yang melakukan penghitungan pada data di bidang tersebut. Di expr, Anda dapat menyertakan nama bidang dalam tabel, kontrol pada formulir, konstanta, atau fungsi. Jika expr menyertakan fungsi, fungsi dapat berupa fungsi bawaan atau ditentukan pengguna, tetapi tidak dengan SQL fungsi agregat atau agregat domain lain.
domain Diperlukan. Ekspresi string yang mengidentifikasi kumpulan rekaman yang membentuk domain. Nama dapat berupa tabel atau nama kueri untuk kueri yang tidak memerlukan parameter.
criteria Opsional. Ekspresi string yang digunakan untuk membatasi rentang data yang DLookup menjalankan fungsi. Misalnya, criteria seringkali setara dengan WHERE klausa dalam SQL ekspresi, tanpa kata WHERE. Jika Anda menghilangkan criteria, fungsi akan DLookup dievaluasi expr terhadap seluruh domain. Setiap bidang yang disertakan dalam criteria juga harus berupa bidang dalam domain. Jika tidak, fungsi akan mengembalikan DLookupNull.

Keterangan

Fungsi ini DLookup mengembalikan satu nilai bidang berdasarkan informasi yang ditentukan dalam criteria. Meskipun criteria opsional, jika Anda tidak memberikan nilai untuk fungsi tersebut, fungsi akan DLookup mengembalikan nilai acak dalam domain.

Jika tidak ada catatan yang criteriamemuaskan , atau jika domain tidak berisi catatan, fungsi akan mengembalikan DLookupNull.

Jika lebih dari satu bidang memenuhi criteria, fungsi ini DLookup mengembalikan kemunculan pertama. Anda harus menentukan kriteria yang memastikan nilai bidang yang dihasilkan oleh DLookup adalah unik. Anda mungkin ingin menggunakan nilai kunci primer untuk kriteria Anda, seperti [EmployeeID] dalam contoh berikut, guna memastikan bahwa mengembalikan DLookup nilai unik:

Dim varX As Variant
varX = DLookup("[LastName]", "Employees", _
    "[EmployeeID] = 1")

Baik Anda menggunakan fungsi dalam DLookup makro atau modul, ekspresi kueri, atau kontrol terhitung, buat argumen dengan criteria hati-hati agar Access mengevaluasinya dengan benar.

Anda dapat menggunakan fungsi ini DLookup untuk menentukan kriteria di baris Kriteria kueri, dalam ekspresi bidang terhitung dalam kueri, atau dalam baris Perbarui Untuk dalam kueri pembaruan.

Anda juga dapat menggunakan fungsi dalam DLookup ekspresi dalam kontrol terhitung pada formulir atau laporan jika bidang yang perlu ditampilkan tidak berada dalam sumber rekaman yang menjadi dasar formulir atau laporan Anda. Sebagai contoh, misalnya Anda memiliki formulir Detail Pesanan berdasarkan tabel Detail Pesanan dengan kotak teks yang disebut ProductID yang menampilkan bidang tersebut ProductID . Untuk mencari dari ProductNameProducts tabel berdasarkan nilai dalam kotak teks, buat kotak teks lain dan atur properti ControlSource-nya ke ekspresi berikut:

=DLookup("[ProductName]", "Products", "[ProductID] =" & Forms![Order Details]!ProductID)

Tips

  • Meskipun Anda dapat menggunakan fungsi DLookup untuk menampilkan nilai dari bidang dalam tabel asing, mungkin lebih efisien untuk membuat kueri yang berisi bidang yang Anda butuhkan dari kedua tabel, lalu mendasarkan formulir atau laporan pada kueri tersebut.
  • Anda juga bisa menggunakan Panduan Pencarian untuk menemukan nilai dalam tabel asing.

Catatan

Perubahan yang belum disimpan pada catatan tidak domain disertakan saat Anda menggunakan fungsi ini. Jika Anda ingin DLookup menggunakan nilai yang diubah, simpan perubahan terlebih dahulu dengan mengklik Simpan Catatan di bawah Catatan pada tab Data , memindahkan fokus ke catatan lain, atau dengan menggunakan metode tersebut Update .

Contoh

Catatan

Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA). Untuk informasi selengkapnya tentang bekerja dengan VBA, lihat Referensi VBA Access.

Contoh berikut mengembalikan informasi nama dari CompanyName bidang rekaman yang memenuhi criteria. Domain adalah tabel Shippers . Argumen ini criteria membatasi kumpulan rekaman yang dihasilkan untuk yang ShipperID sama dengan 1.

Dim varX As Variant
varX = DLookup("[CompanyName]", _
    "Shippers", "[ShipperID] = 1")

Contoh berikutnya dari Shippers tabel menggunakan kontrol ShipperID formulir untuk menyediakan kriteria fungsi DLookup . Referensi ke kontrol tidak disertakan dalam tanda kutip yang menunjukkan string. Hal ini memastikan bahwa setiap kali DLookup berjalan, Access mendapatkan nilai saat ini dari kontrol.

Dim varX As Variant
varX = DLookup("[CompanyName]", "Shippers", _
    "[ShipperID] = " & Forms!Shippers!ShipperID)

Contoh berikutnya menggunakan variabel, intSearch, untuk mendapatkan nilai.

Dim intSearch As Integer
Dim varX As Variant
intSearch = 1
varX = DLookup("[CompanyName]", "Shippers", _
    "[ShipperID] = " & intSearch)