Struktur CDaoQueryDefInfo

Struktur CDaoQueryDefInfo berisi informasi tentang objek querydef yang ditentukan untuk objek akses data (DAO).

Catatan

Objek Akses Data (DAO) didukung melalui Office 2013. DAO 3.6 adalah versi akhir, dan usang.

Sintaks

struct CDaoQueryDefInfo
{
    CString m_strName;               // Primary
    short m_nType;   // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    BOOL m_bUpdatable;               // Secondary
    BOOL m_bReturnsRecords;          // Secondary
    CString m_strSQL;                // All
    CString m_strConnect;            // All
    short m_nODBCTimeout;            // All
};

Parameter

m_strName
Secara unik menamai objek querydef. Untuk informasi selengkapnya, lihat topik "Properti Nama" di Bantuan DAO. Panggil CDaoQueryDef::GetName untuk mengambil properti ini secara langsung.

m_nType
Nilai yang menunjukkan jenis operasional objek querydef. Nilainya bisa menjadi salah satu dari:

• dbQSelect Pilih: kueri memilih rekaman.

• dbQAction Tindakan: kueri memindahkan atau mengubah data tetapi tidak mengembalikan rekaman.

• dbQCrosstab Tab silang: kueri mengembalikan data dalam format seperti spreadsheet.

• dbQDelete Hapus: kueri menghapus sekumpulan baris tertentu.

• dbQUpdate Pembaruan: kueri mengubah sekumpulan rekaman.

• dbQAppend Tambahkan: kueri menambahkan rekaman baru ke akhir tabel atau kueri.

• dbQMakeTable Buat-tabel: kueri membuat tabel baru dari kumpulan rekaman.

• dbQDDL Definisi data: kueri memengaruhi struktur tabel atau bagiannya.

• dbQSQLPassThrough Pass-through: pernyataan SQL diteruskan langsung ke backend database, tanpa pemrosesan menengah.

• dbQSetOperation Gabungan: kueri membuat objek kumpulan rekaman jenis rekam jepret yang berisi data dari semua rekaman yang ditentukan dalam dua tabel atau lebih dengan rekaman duplikat yang dihapus. Untuk menyertakan duplikat, tambahkan kata kunci ALL dalam pernyataan SQL querydef.

• dbQSPTBulk Digunakan dengan dbQSQLPassThrough untuk menentukan kueri yang tidak mengembalikan rekaman.

Catatan

Untuk membuat kueri pass-through SQL, Anda tidak mengatur dbQSQLPassThrough konstanta. Ini diatur secara otomatis oleh mesin database Microsoft Jet saat Anda membuat objek querydef dan mengatur Connect properti .

Untuk informasi selengkapnya, lihat topik "Ketik Properti" di Bantuan DAO.

m_dateCreated
Tanggal dan waktu querydef dibuat. Untuk langsung mengambil tanggal querydef dibuat, panggil fungsi anggota GetDateCreated objek yang CDaoTableDef terkait dengan tabel. Untuk informasi selengkapnya, lihat Keterangan. Lihat juga topik "DateCreated, LastUpdated Properties" di Bantuan DAO.

m_dateLastUpdated
Tanggal dan waktu perubahan terbaru yang dilakukan pada querydef. Untuk langsung mengambil tanggal tabel terakhir diperbarui, panggil fungsi anggota GetDateLastUpdated dari querydef. Untuk informasi selengkapnya, lihat Keterangan. Lihat juga topik "DateCreated, LastUpdated Properties" di Bantuan DAO.

m_bUpdatable
Menunjukkan apakah perubahan dapat dilakukan pada objek querydef. Jika properti ini TRUE, querydef dapat diperbarui; jika tidak, itu tidak. Dapat diperbarui berarti definisi kueri objek querydef dapat diubah. Properti yang dapat diperbarui dari objek querydef diatur ke TRUE jika definisi kueri dapat diperbarui, meskipun kumpulan catatan yang dihasilkan tidak dapat diperbarui. Untuk mengambil properti ini secara langsung, panggil fungsi anggota CanUpdate querydef. Untuk informasi selengkapnya, lihat topik "Properti yang Dapat Diperbarui" di Bantuan DAO.

m_bReturnsRecords
Menunjukkan apakah kueri pass-through SQL ke database eksternal mengembalikan rekaman. Jika properti ini TRUE, kueri mengembalikan rekaman. Untuk langsung mengambil properti ini, panggil CDaoQueryDef::GetReturnsRecords. Tidak semua kueri pass-through SQL ke database eksternal mengembalikan rekaman. Misalnya, pernyataan PEMBARUAN SQL memperbarui rekaman tanpa mengembalikan rekaman, sementara pernyataan SQL SELECT mengembalikan rekaman. Untuk informasi selengkapnya, lihat topik "Properti ReturnsRecords" di Bantuan DAO.

m_strSQL
Pernyataan SQL yang menentukan kueri yang dijalankan oleh objek querydef. Properti SQL berisi pernyataan SQL yang menentukan bagaimana rekaman dipilih, dikelompokkan, dan diurutkan saat Anda menjalankan kueri. Anda bisa menggunakan kueri untuk memilih rekaman yang akan disertakan dalam objek kumpulan rekaman jenis dynaset atau snapshot. Anda juga dapat menentukan kueri massal untuk mengubah data tanpa mengembalikan rekaman. Anda dapat mengambil nilai properti ini secara langsung dengan memanggil fungsi anggota GetSQL querydef.

m_strConnect
Menyediakan informasi tentang sumber database yang digunakan dalam kueri pass-through. Informasi ini mengambil bentuk string sambungkan. Untuk informasi selengkapnya tentang string koneksi, dan untuk informasi tentang mengambil nilai properti ini secara langsung, lihat fungsi anggota CDaoDatabase::GetConnect .

m_nODBCTimeout
Jumlah detik mesin database Microsoft Jet menunggu sebelum kesalahan waktu habis terjadi saat kueri dijalankan pada database Open Database Connectivity (ODBC). Saat Anda menggunakan database ODBC, seperti Microsoft SQL Server, mungkin ada keterlambatan karena lalu lintas jaringan atau penggunaan server ODBC yang berat. Daripada menunggu tanpa batas waktu, Anda dapat menentukan berapa lama mesin Microsoft Jet menunggu sebelum menghasilkan kesalahan. Nilai batas waktu default adalah 60 detik. Anda dapat mengambil nilai properti ini secara langsung dengan memanggil fungsi anggota GetODBCTimeout querydef. Untuk informasi selengkapnya, lihat topik "Properti ODBCTimeout" di Bantuan DAO.

Keterangan

Querydef adalah objek kelas CDaoQueryDef. Referensi ke Primer, Sekunder, dan Semua menunjukkan bagaimana informasi dikembalikan oleh fungsi anggota GetQueryDefInfo di kelas CDaoDatabase.

Informasi yang diambil oleh fungsi anggota CDaoDatabase::GetQueryDefInfo disimpan dalam CDaoQueryDefInfo struktur. Panggil GetQueryDefInfo objek database di mana QueryDefs mengumpulkan objek querydef disimpan. CDaoQueryDefInfo juga mendefinisikan fungsi anggota Dumpdalam pembangunan debug. Anda bisa menggunakan Dump untuk membuang konten CDaoQueryDefInfo dari suatu objek. Kelas CDaoDatabase juga menyediakan fungsi anggota untuk mengakses langsung semua properti yang CDaoQueryDefInfo dikembalikan dalam objek, sehingga Anda jarang memanggil GetQueryDefInfo.

Saat Anda menambahkan objek bidang atau parameter baru ke kumpulan Bidang atau Parameter objek querydef, pengecualian akan dilemparkan jika database yang mendasar tidak mendukung tipe data yang ditentukan untuk objek baru.

Pengaturan tanggal dan waktu berasal dari komputer tempat querydef dibuat atau terakhir diperbarui. Di lingkungan multipengguna, pengguna harus mendapatkan pengaturan ini langsung dari server file menggunakan perintah waktu bersih untuk menghindari perbedaan dalam pengaturan properti DateCreated dan LastUpdated.

Persyaratan

Header: afxdao.h

Lihat juga

Struktur, Gaya, Panggilan Balik, serta Peta Pesan
Kelas CDaoQueryDef
Kelas CDaoDatabase