Objek Rekaman (ADO)

Mewakili baris dari Recordset atau penyedia data, atau objek yang dikembalikan oleh penyedia data semi terstruktur, seperti file atau direktori.

Keterangan

Objek Rekaman mewakili satu baris data, dan memiliki beberapa kesamaan konseptual dengan Recordset satu baris. Bergantung pada kemampuan penyedia Anda, Objek rekaman dapat dikembalikan langsung dari penyedia Anda alih-alih Recordset satu baris, misalnya ketika kueri SQL yang hanya memilih satu baris yang dijalankan. Atau, objek Rekam dapat diperoleh langsung dari objek Recordset . Atau, Rekaman dapat dikembalikan langsung dari penyedia ke data semi terstruktur, seperti penyedia Microsoft Exchange OLE DB.

Anda bisa menampilkan bidang yang terkait dengan objek Rekam dengan cara kumpulan Bidang pada objek Rekaman . ADO memungkinkan kolom bernilai objek termasuk Recordset, SafeArray, dan nilai skalar dalam kumpulan Bidang objek Rekaman .

Jika objek Rekaman mewakili baris dalam Recordset, dimungkinkan untuk kembali ke Recordset asli tersebut dengan properti Sumber .

Objek Rekam juga dapat digunakan oleh penyedia data semi-terstruktur seperti Penyedia Microsoft OLE DB untuk Penerbitan Internet, untuk memodelkan namespace terstruktur pohon. Setiap simpul di pohon adalah objek Rekam dengan kolom terkait. Kolom dapat mewakili atribut simpul tersebut dan informasi relevan lainnya. Objek Rekam dapat mewakili simpul daun dan node non-daun dalam struktur pohon. Simpul non-daun memiliki node lain sebagai kontennya, tetapi simpul daun tidak memiliki konten tersebut. Simpul daun biasanya berisi aliran biner data dan node non-daun mungkin juga memiliki aliran biner default yang terkait dengannya. Properti pada objek Rekam mengidentifikasi jenis simpul.

Objek Rekam juga mewakili cara alternatif untuk menavigasi data yang diatur secara hierarkis. Objek Rekaman dapat dibuat untuk mewakili akar sub-pohon tertentu dalam struktur pohon besar dan objek Rekaman baru dapat dibuka untuk mewakili simpul anak.

Sumber daya (misalnya, file atau direktori) dapat diidentifikasi secara unik oleh URL absolut. Objek Koneksi dibuat secara implisit dan diatur ke objek Rekaman saat Rekaman dibuka dengan menggunakan URL absolut. Objek Koneksi dapat secara eksplisit diatur ke objek Rekaman melalui properti ActiveConnection . File dan direktori yang dapat diakses dengan menggunakan objek Koneksi menentukan konteks di mana operasi Rekaman dapat terjadi.

Modifikasi data dan metode navigasi pada objek Rekaman juga menerima URL relatif, yang menemukan sumber daya menggunakan URL absolut atau konteks objek Koneksi sebagai titik awal.

Catatan

URL yang menggunakan skema http akan secara otomatis memanggil Penyedia Microsoft OLE DB untuk Penerbitan Internet. Untuk informasi selengkapnya, lihat URL Absolut dan Relatif.

Objek Koneksi dikaitkan dengan setiap objek Rekaman . Oleh karena itu, operasi rekam objek dapat menjadi bagian dari transaksi dengan memanggil metode transaksi objek Koneksi .

Objek Rekam tidak mendukung peristiwa ADO, dan oleh karena itu tidak akan merespons pemberitahuan.

Dengan metode dan properti objek Rekaman , Anda bisa melakukan hal berikut:

  • Atur atau kembalikan objek Koneksi terkait dengan properti ActiveConnection .

  • Menunjukkan izin akses dengan properti Mode .

  • Mengembalikan URL direktori, jika ada, yang berisi sumber daya yang diwakili oleh Rekaman dengan properti ParentURL .

  • Tunjukkan URL absolut, URL relatif, atau Recordset tempat Rekaman diturunkan dengan properti Sumber .

  • Menunjukkan status Rekaman saat ini dengan properti Status .

  • Tunjukkan jenis Rekam - dokumensederhana, koleksi, atau terstruktur - dengan properti RecordType.

  • Hentikan eksekusi operasi asinkron dengan metode Batal .

  • Memisahkan Rekaman dari sumber data dengan metode Tutup .

  • Salin file atau direktori yang diwakili oleh Rekaman ke lokasi lain dengan metode CopyRecord .

  • Hapus file, atau direktori dan subdirektori, yang diwakili oleh Rekaman dengan metode DeleteRecord .

  • Buka Recordset yang berisi baris yang mewakili subdirektori dan file entitas yang diwakili oleh Rekaman dengan metode GetChildren .

  • Pindahkan (ganti nama) file, atau direktori dan subdirektori, yang diwakili oleh Rekaman ke lokasi lain dengan metode MoveRecord .

  • Kaitkan Rekaman dengan sumber data yang sudah ada, atau buat file atau direktori baru dengan metode Buka .

Objek Rekam aman untuk pembuatan skrip.

Bagian ini berisi topik berikut.

Lihat juga

Koleksi Bidang (ADO)
Kumpulan Properti (ADO)
Rekaman dan Aliran
Objek Recordset (ADO)