Metode Simpan

  • Artikel

Menyimpan Recordset dalam file atau objek Stream .

Sintaks

  
recordset.Save Destination, PersistFormat

Parameter

Tujuan
Pilihan. Varian yang mewakili nama jalur lengkap file tempat Recordset akan disimpan, atau referensi ke objek Stream.

PersistFormat
Pilihan. Nilai PersistFormatEnum yang menentukan format tempat Recordset akan disimpan (XML atau ADTG). Nilai defaultnya adalah adPersistADTG.

Keterangan

Metode Simpan Metode hanya dapat dipanggil pada Recordset yang terbuka. Gunakan metode Open Method (ADO Recordset) untuk memulihkan Recordset dari Tujuan nanti.

Jika properti Properti Filter berlaku untuk Recordset, maka hanya baris yang dapat diakses di bawah filter yang disimpan. Jika Recordset bersifat hierarkis, maka Recordset turunan saat ini dan turunannya disimpan, termasuk Recordset induk. Jika metode Simpan dari Recordset anak dipanggil, anak dan semua turunannya disimpan, tetapi induknya tidak.

Pertama kali Anda menyimpan Recordset, opsional untuk menentukan Tujuan. Jika Anda menghilangkan Tujuan, file baru akan dibuat dengan nama yang diatur ke nilai properti Sumber dari Recordset.

Hilangkan Tujuan saat Anda kemudian memanggil Simpan setelah penyimpanan pertama, atau kesalahan run-time akan terjadi. Jika Anda kemudian memanggil Simpan dengan Tujuan baru, Recordset disimpan ke tujuan baru. Namun, tujuan baru dan tujuan asli keduanya akan terbuka.

Simpan tidak menutup Recordset atau Destination, sehingga Anda bisa terus bekerja dengan Recordset dan menyimpan perubahan terbaru Anda. Tujuan tetap terbuka hingga Recordset ditutup.

Untuk alasan keamanan, metode Simpan hanya mengizinkan penggunaan pengaturan keamanan rendah dan kustom dari skrip yang dijalankan oleh Microsoft Internet Explorer.

Jika metode Simpan dipanggil saat operasi Pengambilan, eksekusi, atau pembaruan Recordset asinkron sedang berlangsung, maka Simpan menunggu hingga operasi asinkron selesai.

Rekaman disimpan dimulai dengan baris pertama Recordset. Ketika metode Simpan selesai, posisi baris saat ini dipindahkan ke baris pertama Dari Recordset.

Untuk hasil terbaik, atur properti Properti CursorLocation (ADO) ke adUseClient dengan Simpan. Jika penyedia Anda tidak mendukung semua fungsionalitas yang diperlukan untuk menyimpan objek Recordset , Layanan Kursor akan menyediakan fungsionalitas tersebut.

Saat Recordset dipertahankan dengan properti CursorLocation yang diatur ke adUseServer, kemampuan pembaruan untuk Recordset dibatasi. Biasanya, hanya pembaruan tabel tunggal, penyisipan, dan penghapusan yang diizinkan (bergantung pada fungsionalitas penyedia). Metode Resync Method juga tidak tersedia dalam konfigurasi ini.

Catatan

Menyimpan Recordset dengan Bidang jenis adVariant, adIDispatch, atau adIUnknown tidak didukung oleh ADO dan dapat menyebabkan hasil yang tidak dapat diprediksi.

Hanya Filter dalam bentuk String Kriteria (misalnya OrderDate > '31/12/1999') yang memengaruhi konten Recordset yang bertahan. Filter yang dibuat dengan Array Bookmark atau menggunakan nilai dari FilterGroupEnum tidak akan memengaruhi konten Recordset yang bertahan. Aturan ini berlaku untuk Recordsetyang dibuat dengan kursor sisi klien atau sisi server.

Karena parameter Tujuan dapat menerima objek apa pun yang mendukung antarmuka IStream OLE DB, Anda dapat menyimpan Recordset langsung ke objek Respons ASP. Untuk detail selengkapnya, silakan lihat Skenario Persistensi Kumpulan Catatan XML.

Anda juga dapat menyimpan Recordset dalam format XML ke instans objek DOM MSXML, seperti yang diperlihatkan dalam kode Visual Basic berikut:

Dim xDOM As New MSXML.DOMDocument  
Dim rsXML As New ADODB.Recordset  
Dim sSQL As String, sConn As String  
  
sSQL = "SELECT customerid, companyname, contactname FROM customers"  
sConn="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Northwind.mdb"  
rsXML.Open sSQL, sConn  
rsXML.Save xDOM, adPersistXML   'Save Recordset directly into a DOM tree.  
...

Catatan

Dua batasan berlaku saat menyimpan Recordset hierarkis (bentuk data) dalam format XML. Anda tidak dapat menyimpan ke XML jika Recordset hierarkis berisi pembaruan yang tertunda, dan Anda tidak dapat menyimpan Recordset hierarkis berparameter.

Kumpulan catatan yang disimpan dalam format XML disimpan menggunakan format UTF-8. Ketika file tersebut dimuat ke dalam Aliran ADO, objek Stream tidak akan mencoba membuka Recordset dari aliran kecuali properti Charset aliran diatur ke nilai yang sesuai untuk format UTF-8.

Berlaku Untuk

Objek Recordset (ADO)

Objek Aliran (ADO)

Lihat juga

Contoh Metode Simpan dan Buka (Visual Basic)
Contoh Simpan dan Buka Metode (VC++)
Metode Terbuka (Recordset ADO)
Metode Terbuka (Aliran ADO)
Metode SaveToFile