Simpan Metode

Menyimpan Recordset dalam file atau objek Stream.

Sintaksis

  
recordset.Save Destination, PersistFormat  

Parameter

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

PersistFormat
Fakultatif. Nilai PersistFormatEnum yang menentukan format di mana Recordset akan disimpan (XML atau ADTG). Nilai defaultnya adalah adPersistADTG.

Komentar

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

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 anak Recordset dipanggil, anak dan semua anaknya disimpan, tetapi induknya tidak.

Pertama kali Anda menyimpan Recordset , anda dapat menentukan Destination. 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 Tujuanbaru , Recordset disimpan ke tujuan baru. Namun, tujuan baru dan tujuan asli keduanya akan terbuka.

Simpan tidak menutup Recordset atau Destination, sehingga Anda dapat 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 Recordset asinkron mengambil, menjalankan, atau memperbarui operasi 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 Recordset .

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

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

Nota

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') memengaruhi konten Recordset. Filter yang dibuat dengan Array bookmark atau menggunakan nilai dari FilterGroupEnum tidak akan memengaruhi konten Recordsetyang dipertahankan. 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 Himpunan Catatan XML .

Anda juga dapat menyimpan Recordset dalam format XML ke instans objek DOM MSXML, seperti yang ditunjukkan 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.  
...  

Nota

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

Recordset disimpan dalam format XML disimpan menggunakan format UTF-8. Ketika file seperti itu 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

Recordset Object (ADO)

Stream Object (ADO)

Lihat Juga

Simpan dan Buka Metode (VB)
Contoh Simpan dan Buka Metode (VC++)
Metode Terbuka (ADO Recordset)
Open Method (ADO Stream)
Metode SaveToFile