Metode Tambahan (ADO)

Menambahkan objek ke koleksi. Jika koleksi adalah Bidang, objek Bidang baru dapat dibuat sebelum ditambahkan ke koleksi.

Sintaks

  
collection.Append object  
fields.Append Name, Type, DefinedSize, Attrib, FieldValue  

Parameter

Koleksi
Objek koleksi.

Bidang
Kumpulan Bidang .

objek
Variabel objek yang mewakili objek yang akan ditambahkan.

Nama
Nilai String yang berisi nama objek Bidang baru, dan tidak boleh sama dengan objek lain dalam bidang.

Jenis
Nilai DataTypeEnum , yang nilai defaultnya adalah adEmpty, yang menentukan jenis data bidang baru. Jenis data berikut tidak didukung oleh ADO, dan tidak boleh digunakan saat menambahkan bidang baru ke Objek Recordset (ADO): adIDispatch, adIUnknown, adVariant.

DefinedSize
Opsional. Nilai Panjang yang mewakili ukuran yang ditentukan, dalam karakter atau byte, dari bidang baru. Nilai default untuk parameter ini berasal dari Jenis. Bidang yang memiliki DefinedSize yang lebih besar dari 255 byte diperlakukan sebagai kolom panjang variabel. Default untuk DefinedSize tidak ditentukan.

Attrib
Opsional. Nilai FieldAttributeEnum , yang nilai defaultnya adalah adFldDefault, yang menentukan atribut untuk bidang baru. Jika nilai ini tidak ditentukan, bidang akan berisi atribut yang berasal dari Jenis.

Nilai Bidang
Opsional. Varian yang mewakili nilai untuk bidang baru. Jika tidak ditentukan, bidang ditambahkan dengan nilai null.

Keterangan

Koleksi Parameter

Anda harus mengatur properti Jenis objek Parameter sebelum menambahkannya ke koleksi Parameter . Jika Anda memilih jenis data dengan panjang variabel, Anda juga harus mengatur properti Ukuran ke nilai yang lebih besar dari nol.

Menjelaskan sendiri parameter meminimalkan panggilan ke penyedia dan oleh karena itu meningkatkan performa saat Anda menggunakan prosedur tersimpan atau kueri berparameter. Namun, Anda harus mengetahui properti parameter yang terkait dengan prosedur tersimpan atau kueri berparameter yang ingin Anda panggil.

Gunakan metode CreateParameter untuk membuat objek Parameter dengan pengaturan properti yang sesuai dan gunakan metode Tambahkan untuk menambahkannya ke koleksi Parameter . Ini memungkinkan Anda mengatur dan mengembalikan nilai parameter tanpa harus memanggil penyedia untuk informasi parameter. Jika Anda menulis ke penyedia yang tidak menyediakan informasi parameter, Anda harus menggunakan metode ini untuk mengisi koleksi Parameter secara manual untuk menggunakan parameter sama sekali.

Kumpulan Bidang

Parameter FieldValue hanya valid saat menambahkan objek Bidang ke objek Rekaman , bukan ke objek Recordset . Dengan objek Rekam , Anda dapat menambahkan bidang dan menyediakan nilai secara bersamaan. Dengan objek Recordset , Anda harus membuat bidang saat Recordset ditutup, lalu membuka Recordset dan menetapkan nilai ke bidang.

Catatan

Untuk objek Bidang baru yang telah ditambahkan ke kumpulan Bidang dari objek Rekaman , properti Nilai harus diatur sebelum properti Bidang lainnya dapat ditentukan. Pertama, nilai tertentu untuk properti Nilai harus telah ditetapkan dan Perbarui pada koleksi Bidang yang disebut. Kemudian, properti lain seperti Jenis atau Atribut dapat diakses. Objek bidang dari tipe data berikut (DataTypeEnum) tidak dapat ditambahkan ke koleksi Bidang dan akan menyebabkan kesalahan terjadi: adArray, adChapter, adEmpty, adPropVariant, dan adUserDefined. Selain itu, jenis data berikut tidak didukung oleh ADO: adIDispatch, adIUnknown, dan adIVariant. Untuk jenis ini, tidak ada kesalahan yang akan terjadi ketika ditambahkan, tetapi penggunaan dapat menghasilkan hasil yang tidak dapat diprediksi termasuk kebocoran memori.

Recordset

Jika Anda tidak mengatur properti CursorLocation sebelum memanggil metode Tambahkan , CursorLocation akan diatur ke adUseClient (nilai CursorLocationEnum ) secara otomatis saat metode Buka objek Recordset dipanggil.

Kesalahan run-time akan terjadi jika metode Tambahkan dipanggil pada kumpulan Bidang dari Recordset yang terbuka, atau pada Recordset tempat properti ActiveConnection telah diatur. Anda hanya dapat menambahkan bidang ke Recordset yang belum terbuka dan belum tersambung ke sumber data. Ini biasanya terjadi ketika objek Recordset dibuat dengan metode CreateRecordset atau ditetapkan ke variabel objek.

Rekaman

Kesalahan run-time tidak akan terjadi jika metode Tambahkan dipanggil pada kumpulan Bidang dari Rekaman yang terbuka. Bidang baru akan ditambahkan ke kumpulan Bidang dari objek Rekaman . Jika Rekaman berasal dari Recordset, bidang baru tidak akan muncul di kumpulan Bidang objek Recordset .

Bidang yang tidak ada dapat dibuat dan ditambahkan ke koleksi Bidang dengan menetapkan nilai ke objek bidang seolah-olah sudah ada dalam koleksi. Penugasan akan memicu pembuatan otomatis dan penambahan objek Bidang , dan kemudian penugasan akan selesai.

Setelah menambahkan Bidang ke kumpulan Bidang dari objek Rekaman , panggil metode Perbarui kumpulan Bidang untuk menyimpan perubahan.

Berlaku Untuk

Lihat juga

Contoh Metode Tambahkan dan CreateParameter (Visual Basic)
Contoh Metode Tambahkan dan CreateParameter (VC++)
Metode CreateParameter (ADO)
Metode Hapus (Kumpulan Bidang ADO)
Metode Hapus (Koleksi Parameter ADO)
Metode Hapus (ADO Recordset)
Metode Pembaruan