Rekaman dan Bidang yang Disediakan Penyedia
Saat objek Rekaman dibuka, sumbernya dapat menjadi baris Saat ini dari Recordset terbuka, URL absolut, atau URL relatif bersama dengan objek Koneksi terbuka.
Jika Rekaman dibuka dari Recordset, koleksi Bidang objek Rekaman akan berisi semua bidang dari Recordset, ditambah bidang apa pun yang ditambahkan oleh penyedia yang mendasar.
Penyedia dapat menyisipkan bidang tambahan yang berfungsi sebagai karakteristik tambahan rekaman. Akibatnya, Rekaman mungkin memiliki bidang unik yang tidak ada di Recordset secara keseluruhan atau Rekaman apa pun yang berasal dari baris Lain dari Recordset.
Misalnya, semua baris Recordset yang berasal dari sumber data email mungkin memiliki kolom seperti Dari, Ke, dan Subjek. Rekaman yang berasal dari Recordset tersebut akan memiliki bidang yang sama. Namun, Rekaman mungkin juga memiliki bidang lain yang unik untuk pesan tertentu yang diwakili oleh Rekaman tersebut, seperti Lampiran dan Cc (salinan karbon).
Meskipun objek Rekam dan baris Recordset saat ini memiliki bidang yang sama, objek tersebut berbeda karena objek Record dan Recordset memiliki metode dan properti yang berbeda.
Bidang yang dipegang bersama oleh Rekaman dan Recordset dapat dimodifikasi pada salah satu objek. Namun, bidang tidak dapat dihapus pada objek Rekaman , meskipun penyedia yang mendasar dapat mendukung pengaturan bidang ke null.
Setelah Rekaman dibuka, Anda dapat menambahkan bidang secara terprogram. Anda juga bisa menghapus bidang yang telah Anda tambahkan, tetapi Anda tidak dapat menghapus bidang dari Recordset asli.
Anda juga dapat membuka objek Rekam langsung dari URL. Dalam hal ini, bidang yang ditambahkan ke Rekaman bergantung pada penyedia yang mendasar. Saat ini, sebagian besar penyedia menambahkan sekumpulan bidang yang menjelaskan entitas yang diwakili oleh Rekaman. Jika entitas terdiri dari aliran byte, seperti file sederhana, objek Stream biasanya dapat dibuka dari Rekaman.
Bidang Khusus untuk Penyedia Sumber Dokumen
Kelas penyedia khusus, yang disebut penyedia sumber dokumen, mengelola folder dan dokumen. Saat objek Rekaman mewakili dokumen atau objek Recordset mewakili folder dokumen, penyedia sumber dokumen mengisi objek tersebut dengan sekumpulan bidang unik yang menjelaskan karakteristik dokumen alih-alih dokumen aktual itu sendiri. Biasanya, satu bidang berisi referensi ke Stream yang mewakili dokumen.
Bidang-bidang ini merupakan rekaman sumber daya atau recordset dan terdaftar untuk penyedia tertentu yang mendukungnya di Lampiran A: Penyedia.
Dua konstanta mengindeks kumpulan Bidang dari Rekaman sumber daya atau Recordset untuk mengambil sepasang bidang yang umum digunakan. Properti Nilai objek Bidang mengembalikan konten yang diinginkan.
Bidang yang diakses dengan konstanta adDefaultStream berisi aliran default yang terkait dengan objek Rekam atau Recordset . Penyedia menetapkan aliran default ke objek.
Bidang yang diakses dengan konstanta adRecordURL berisi URL absolut yang mengidentifikasi dokumen.
Penyedia sumber dokumen tidak mendukung kumpulan Properti objek Rekaman dan Bidang . Konten koleksi Properti null untuk objek tersebut.
Penyedia sumber dokumen dapat menambahkan properti khusus penyedia seperti Jenis Sumber Data untuk mengidentifikasi apakah itu penyedia sumber dokumen. Untuk informasi selengkapnya tentang cara menentukan jenis penyedia Anda, lihat dokumentasi penyedia Anda.
Kolom Kumpulan Catatan Sumber Daya
Kumpulan catatan sumber daya terdiri dari kolom berikut.
| Nama kolom | Jenis | Deskripsi |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Baca-saja. Menunjukkan URL sumber daya. |
| RESOURCE_PARENTNAME | AdVarWChar | Baca-saja. Menunjukkan URL absolut rekaman induk. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Baca-saja. Menunjukkan URL absolut sumber daya, yang merupakan perangkaian PARENTNAME dan PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | True jika sumber daya disembunyikan. Tidak ada baris yang akan dikembalikan kecuali perintah yang membuat set baris secara eksplisit memilih baris di mana RESOURCE_ISHIDDEN true. |
| RESOURCE_ISREADONLY | AdBoolean | True jika sumber daya bersifat baca-saja. Mencoba membuka sumber daya ini dengan DBBINDFLAG_WRITE dan akan gagal dengan DB_E_READONLY. Properti ini dapat diedit bahkan ketika sumber daya hanya dibuka untuk dibaca. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Menunjukkan kemungkinan penggunaan dokumen-misalnya, singkat pengacara. Ini mungkin sesuai dengan templat Office yang digunakan untuk membuat dokumen. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Menunjukkan jenis MIME dokumen, menunjukkan format seperti "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Menunjukkan bahasa tempat konten disimpan. |
| RESOURCE_CREATIONTIME | adFileTime | Baca-saja. Menunjukkan struktur FILETIME yang berisi waktu sumber daya dibuat. Waktu dilaporkan dalam format Waktu Universal Terkoordinasi (UTC). |
| RESOURCE_LASTACCESSTIME | AdFileTime | Baca-saja. Menunjukkan struktur FILETIME yang berisi waktu sumber daya terakhir diakses. Waktunya dalam format UTC. Anggota FILETIME nol jika penyedia tidak mendukung anggota kali ini. |
| RESOURCE_LASTWRITETIME | AdFileTime | Baca-saja. Menunjukkan struktur FILETIME yang berisi waktu sumber daya terakhir ditulis. Waktunya dalam format UTC. Anggota FILETIME nol jika penyedia tidak mendukung anggota kali ini. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Baca-saja. Menunjukkan ukuran aliran default sumber daya, dalam byte. |
| RESOURCE_ISCOLLECTION | AdBoolean | Baca-saja. True jika sumber daya adalah koleksi, seperti direktori. False jika sumber daya adalah file sederhana. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True jika sumber daya adalah dokumen terstruktur. False jika sumber daya bukan dokumen terstruktur. Ini bisa berupa koleksi atau file sederhana. |
| DEFAULT_DOCUMENT | AdVarWChar | Baca-saja. Menunjukkan bahwa sumber daya ini berisi URL ke dokumen sederhana default folder atau dokumen terstruktur. Digunakan saat aliran default diminta dari sumber daya. Properti ini kosong untuk file sederhana. |
| CHAPTERED_CHILDREN | AdChapter | Baca-saja. Pilihan. Menunjukkan bab set baris yang berisi anak-anak sumber daya. ( Penyedia OLE DB untuk Penerbitan Internet tidak menggunakan kolom ini.) |
| RESOURCE_DISPLAYNAME | AdVarWChar | Baca-saja. Menunjukkan nama tampilan sumber daya. |
| RESOURCE_ISROOT | AdBoolean | Baca-saja. True jika sumber daya adalah akar koleksi atau dokumen terstruktur. |