Properti dan Perilaku Himpunan Baris (penyedia OLE DB Klien Asli)
Berlaku untuk:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Ini adalah properti kumpulan baris penyedia SQL Server Native Client OLE DB.
| ID Properti | Deskripsi |
|---|---|
| DBPROP_ABORTPRESERVE | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Perilaku set baris setelah operasi pembatalan ditentukan oleh properti ini. VARIANT_FALSE: Penyedia SQL Server Native Client OLE DB membatalkan set baris setelah operasi batalkan. Fungsionalitas objek set baris hampir hilang. Ini hanya mendukung operasi IUnknown dan rilis handel baris dan aksesor yang luar biasa. VARIANT_TRUE: Penyedia SQL Server Native Client OLE DB mempertahankan set baris yang valid. |
| DBPROP_ACCESSORDER | R/W: Baca/tulis Default: DBPROPVAL_AO_RANDOM Deskripsi: Urutan akses. Urutan di mana kolom harus diakses pada set baris. DBPROPVAL_AO_RANDOM: Kolom dapat diakses dalam urutan apa pun. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Kolom yang terikat sebagai objek penyimpanan hanya dapat diakses dalam urutan berurutan yang ditentukan oleh ordinal kolom. DBPROPVAL_AO_SEQUENTIAL: Semua kolom harus diakses dalam urutan berurutan yang ditentukan oleh ordinal kolom. |
| DBPROP_APPENDONLY | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Blok objek penyimpanan penyedia SQL Server Native Client OLE DB menggunakan metode set baris lainnya. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung marka buku untuk identifikasi baris set baris saat DBPROP_BOOKMARKS atau DBPROP_LITERALBOOKMARKS VARIANT_TRUE. Mengatur salah satu properti ke VARIANT_TRUE tidak mengaktifkan penempatan set baris menurut marka buku. Atur DBPROP_IRowsetLocate atau DBPROP_IRowsetScroll ke VARIANT_TRUE untuk membuat set baris yang mendukung penempatan set baris menurut marka buku. Penyedia SQL Server Native Client OLE DB menggunakan kursor Microsoft SQL Server untuk mendukung set baris yang berisi marka buku. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. Catatan: Mengatur properti ini bertentangan dengan properti penentuan kursor penyedia SQL Server Native Client OLE DB lainnya menyebabkan kesalahan. Misalnya, mengatur DBPROP_BOOKMARKS ke VARIANT_TRUE saat DBPROP_OTHERINSERT juga VARIANT_TRUE menghasilkan kesalahan saat konsumen mencoba membuka set baris. |
| DBPROP_BOOKMARKSKIPPED | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mengembalikan DB_E_BADBOOKMARK jika konsumen menunjukkan marka buku yang tidak valid saat memposisikan atau mencari set baris yang diberi marka buku. |
| DBPROP_BOOKMARKTYPE | R/W: Baca-saja Default: DBPROPVAL_BMK_NUMERIC Deskripsi: Penyedia SQL Server Native Client OLE DB hanya mengimplementasikan marka buku numerik. Bookmark penyedia SQL Server Native Client OLE DB adalah bilangan bulat yang tidak ditandatangani 32-bit, ketik DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung pengambilan dan pengguliran mundur dalam set baris yang tidak berurut. Penyedia SQL Server Native Client OLE DB membuat set baris yang didukung kursor saat DBPROP_CANFETCHBACKWARDS atau DBPROP_CANSCROLLBACKWARDS VARIANT_TRUE. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. |
| DBPROP_CANHOLDROWS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Secara default, penyedia SQL Server Native Client OLE DB mengembalikan DB_E_ROWSNOTRELEASED jika konsumen mencoba mendapatkan lebih banyak baris untuk set baris sambil perubahan tertunda ada pada baris yang saat ini ada di set baris. Perilaku ini dapat dimodifikasi. Mengatur DBPROP_CANHOLDROWS dan DBPROP_IRowsetChange ke VARIANT_TRUE menyiratkan set baris yang diberi bookmark. Jika kedua properti VARIANT_TRUE, antarmuka IRowsetLocate tersedia di set baris dan DBPROP_BOOKMARKS dan DBPROP_LITERALBOOKMARKS keduanya VARIANT_TRUE. Kumpulan baris penyedia SQL Server Native Client OLE DB yang berisi marka buku didukung oleh kursor SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Properti ini hanya dapat diatur ke VARIANT_TRUE jika set baris menggunakan kursor berbasis set kunci. |
| DBPROP_COLUMNRESTRICT | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mengatur properti ke VARIANT_TRUE ketika kolom dalam set baris tidak dapat diubah oleh konsumen. Kolom lain dalam set baris mungkin dapat diperbarui dan baris itu sendiri dapat dihapus. Ketika properti VARIANT_TRUE, konsumen memeriksa anggota dwFlags dari struktur DBCOLUMNINFO untuk menentukan apakah nilai kolom individu dapat ditulis atau tidak. Untuk kolom yang dapat dimodifikasi, dwFlags menunjukkan DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | R/W: Baca/tulis Default: 0 Deskripsi: Secara default, penyedia SQL Server Native Client OLE DB tidak kehabisan waktu pada metode ICommand::Execute . |
| DBPROP_COMMITPRESERVE | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Perilaku set baris setelah operasi penerapan ditentukan oleh properti ini. VARIANT_TRUE: Penyedia SQL Server Native Client OLE DB mempertahankan set baris yang valid. VARIANT_FALSE: Penyedia SQL Server Native Client OLE DB membatalkan set baris setelah operasi penerapan. Fungsionalitas objek set baris hampir hilang. Ini hanya mendukung operasi IUnknown dan rilis handel baris dan aksesor yang luar biasa. |
| DBPROP_DEFERRED | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Saat diatur ke VARIANT_TRUE penyedia SQL Server Native Client OLE DB mencoba menggunakan kursor server untuk set baris. Kolom teks, ntext, dan gambar tidak dikembalikan dari server hingga diakses oleh aplikasi. |
| DBPROP_DELAYSTORAGEOBJECTS | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung mode pembaruan langsung pada objek penyimpanan. Perubahan yang dilakukan pada data dalam objek aliran berurutan segera dikirimkan ke SQL Server. Modifikasi dilakukan berdasarkan mode transaksi set baris. |
| DBPROP_HIDDENCOLUMNS | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Jumlah Kolom Tersembunyi Jika DBPROP_UNIQUEROWS VARIANT_TRUE, properti DBPROP_HIDDENCOLUMNS mengembalikan jumlah kolom "tersembunyi" tambahan yang ditambahkan oleh penyedia untuk mengidentifikasi baris secara unik dalam set baris. Kolom ini dikembalikan oleh IColumnsInfo::GetColumnInfo dan IColumnsRowset::GetColumnsRowset. Namun, baris tidak disertakan dalam jumlah baris yang dikembalikan oleh argumen pcColumns yang dikembalikan oleh IColumnsInfo::GetColumnInfo. Untuk menentukan jumlah total kolom yang diwakili dalam struktur prgInfo yang dikembalikan oleh IColumnsInfo::GetColumnInfo, termasuk kolom tersembunyi, konsumen menambahkan nilai DBPROP_HIDDENCOLUMNS ke hitungan kolom yang dikembalikan dari IColumnsInfo::GetColumnInfo di pcColumns. Jika DBPROP_UNIQUEROWS VARIANT_FALSE, DBPROP_HIDDENCOLUMNS adalah nol. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung antarmuka ini pada semua set baris. |
| DBPROP_IColumnsRowset | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung antarmuka IColumnsRowset . |
| DBPROP_IConnectionPointContainer | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: IConnectionPointContainer. Jika VARIANT_TRUE, set baris mendukung antarmuka yang ditentukan. Jika VARIANT_FALSE, set baris tidak mendukung antarmuka yang ditentukan. Penyedia yang mendukung antarmuka harus mendukung properti yang terkait dengan antarmuka tersebut dengan nilai VARIANT_TRUE. Properti ini terutama digunakan untuk meminta antarmuka melalui ICommandProperties::SetProperties. |
| DBPROP_IMultipleResults | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung antarmuka IMultipleResults . |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung antarmuka IRowsetChange dan IRowsetUpdate . Set baris yang dibuat dengan menggunakan DBPROP_IRowsetChange sama dengan VARIANT_TRUE menunjukkan perilaku mode pembaruan langsung. Ketika DBPROP_IRowsetUpdate VARIANT_TRUE, DBPROP_IRowsetChange juga VARIANT_TRUE. Set baris menunjukkan perilaku mode pembaruan yang tertunda. Penyedia SQL Server Native Client OLE DB menggunakan kursor SQL Server untuk mendukung set baris yang mengekspos IRowsetChange atau IRowsetUpdate. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. |
| DBPROP_IRowsetIdentity | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung antarmuka IRowsetIdentity . Jika set baris mendukung antarmuka ini, setiap dua handel baris yang mewakili baris yang mendasar yang sama akan selalu mencerminkan data dan status yang sama. Konsumen dapat memanggil metode IRowsetIdentity:: IsSameRow untuk membandingkan dua handel baris untuk melihat apakah mereka merujuk ke instans baris yang sama. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB dapat mengekspos antarmuka IRowsetLocate dan IRowsetScroll . Ketika DBPROP_IRowsetLocate VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS dan DBPROP_CANSCROLLBACKWARDS juga VARIANT_TRUE. Saat DBPROP_IRowsetScroll VARIANT_TRUE, DBPROP_IRowsetLocate juga VARIANT_TRUE, dan kedua antarmuka tersedia di set baris. Marka buku diperlukan untuk salah satu antarmuka. Penyedia SQL Server Native Client OLE DB mengatur DBPROP_BOOKMARKS dan DBPROP_LITERALBOOKMARKS ke VARIANT_TRUE ketika konsumen meminta salah satu antarmuka. Penyedia SQL Server Native Client OLE DB menggunakan kursor SQL Server untuk mendukung IRowsetLocate dan IRowsetScroll. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. Mengatur properti ini bertentangan dengan properti penentuan kursor penyedia SQL Server Native Client OLE DB lainnya menyebabkan kesalahan. Misalnya, mengatur DBPROP_IRowsetScroll ke VARIANT_TRUE saat DBPROP_OTHERINSERT juga VARIANT_TRUE menghasilkan kesalahan saat konsumen mencoba membuka set baris. |
| DBPROP_IRowsetResynch | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mengekspos antarmuka IRowsetResynch sesuai permintaan. Penyedia SQL Server Native Client OLE DB dapat mengekspos antarmuka pada set baris apa pun. |
| DBPROP_ISupportErrorInfo | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Penyedia SQL Server Native Client OLE DB mengekspos antarmuka ISupportErrorInfo pada set baris. |
| DBPROP_ILockBytes | Antarmuka ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis properti menghasilkan kesalahan. |
| DBPROP_ISequentialStream | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mengekspos antarmuka ISequentialStream untuk mendukung data panjang dan panjang variabel yang disimpan di SQL Server. |
| DBPROP_IStorage | Antarmuka ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis properti menghasilkan kesalahan. |
| DBPROP_IStream | Antarmuka ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis properti menghasilkan kesalahan. |
| DBPROP_IMMOBILEROWS | R/W: Baca/tulis Default: VARIANT_TRUE Deskripsi: Properti hanya VARIANT_TRUE untuk kursor set kunci SQL Server; ini VARIANT_FALSE untuk semua kursor lainnya. VARIANT_TRUE: Kumpulan baris tidak akan menyusun ulang baris yang disisipkan atau diperbarui. Untuk IRowsetChange::InsertRow, baris akan muncul di akhir set baris. Untuk IRowsetChange::SetData, jika set baris tidak diurutkan, posisi baris yang diperbarui tidak diubah. Jika set baris diurutkan dan IRowsetChange::SetData mengubah kolom yang digunakan untuk mengurutkan set baris, baris tidak dipindahkan. Jika set baris dibangun pada sekumpulan kolom kunci (biasanya kumpulan baris yang DBPROP_OTHERUPDATEDELETE VARIANT_TRUE tetapi DBPROP_OTHERINSERT VARIANT_FALSE), mengubah nilai kolom kunci umumnya setara dengan menghapus baris saat ini dan menyisipkan yang baru. Oleh karena itu, baris mungkin tampak bergerak atau bahkan menghilang dari set baris, jika DBPROP_OWNINSERT VARIANT_FALSE, meskipun properti DBPROP_IMMOBILEROWS VARIANT_TRUE. VARIANT_FALSE: Jika set baris diurutkan, baris yang disisipkan muncul dalam urutan set baris yang benar. Jika set baris tidak diurutkan, baris yang disisipkan akan muncul di akhir. Jika IRowsetChange::SetData mengubah kolom yang digunakan untuk mengurutkan set baris, baris akan dipindahkan. Jika set baris tidak diurutkan, posisi baris tidak diubah. |
| DBPROP_LITERALIDENTITY | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Properti ini selalu VARIANT_TRUE. |
| DBPROP_LOCKMODE | R/W: Baca/tulis Default: DBPROPVAL_LM_NONE Deskripsi: Tingkat penguncian yang dilakukan oleh set baris (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Catatan: Saat menggunakan isolasi rekam jepret dalam transaksi, jika set baris dibuka dengan menggunakan set kunci atau kursor server dinamis dan mode kunci diatur ke DBPROPVAL_LM_SINGLEROW, kesalahan akan terjadi saat mengambil baris jika orang lain telah memperbarui baris tersebut sejak transaksi dimulai. Untuk jenis kursor dan mode kunci lainnya, jika orang lain telah memperbarui baris sejak transaksi dimulai, kesalahan tidak terjadi sampai pengguna mencoba memperbarui baris. Dalam kedua kasus, kesalahan ini dihasilkan oleh server. |
| DBPROP_MAXOPENROWS | R/W: Baca-saja Default: 0 Deskripsi: Penyedia SQL Server Native Client OLE DB tidak membatasi jumlah baris yang dapat aktif dalam set baris. |
| DBPROP_MAXPENDINGROWS | R/W: Baca-saja Default: 0 Deskripsi: Penyedia SQL Server Native Client OLE DB tidak membatasi jumlah baris set baris dengan perubahan tertunda. |
| DBPROP_MAXROWS | R/W: Baca/tulis Default: 0 Deskripsi: Secara default, penyedia SQL Server Native Client OLE DB tidak membatasi jumlah baris dalam set baris. Saat konsumen menetapkan DBPROP_MAXROWS, penyedia SQL Server Native Client OLE DB menggunakan pernyataan SET ROWCOUNT untuk membatasi jumlah baris dalam set baris. SET ROWCOUNT dapat menyebabkan konsekuensi yang tidak diinginkan dalam eksekusi pernyataan SQL Server. Untuk informasi selengkapnya, lihat MENGATUR ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_MEMORYUSAGE | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_NOTIFICATIONGRANULARITY | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_NOTIFICATIONPHASES | R/W: Baca-saja Default: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung semua fase pemberitahuan. |
| DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | R/W: Baca-saja Default: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Deskripsi: Fase pemberitahuan penyedia SQL Server Native Client OLE DB dapat dibatalkan sebelum upaya untuk melakukan modifikasi set baris yang ditunjukkan. Penyedia SQL Server Native Client OLE DB tidak mendukung pembatalan fase setelah upaya selesai. |
| DBPROP_ORDEREDBOOKMARKS | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Mengatur properti visibilitas perubahan menyebabkan penyedia SQL Server Native Client OLE DB menggunakan kursor SQL Server untuk mendukung set baris. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. |
| DBPROP_QUICKRESTART | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Saat diatur ke VARIANT_TRUE, penyedia SQL Server Native Client OLE DB mencoba menggunakan kursor server untuk set baris. |
| DBPROP_REENTRANTEVENTS | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Kumpulan baris penyedia SQL Server Native Client OLE DB berlabuh kembali dan dapat mengembalikan DB_E_NOTREENTRANT jika konsumen mencoba mengakses metode set baris non-entrant dari panggilan balik pemberitahuan. |
| DBPROP_REMOVEDELETED | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB mengubah nilai properti berdasarkan visibilitas perubahan pada data SQL Server yang diekspos oleh set baris. VARIANT_TRUE: Baris yang dihapus oleh konsumen atau pengguna SQL Server lainnya dihapus dari set baris saat set baris di-refresh. DBPROP_OTHERINSERT is VARIANT_TRUE. VARIANT_FALSE: Baris yang dihapus oleh konsumen atau pengguna SQL Server lainnya tidak dihapus dari set baris saat set baris di-refresh. Nilai status baris untuk baris SQL Server yang dihapus dalam set baris DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT is VARIANT_TRUE. Properti ini hanya memiliki nilai untuk set baris yang didukung oleh kursor SQL Server. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. Ketika properti DBPROP_REMOVEDELETED diimplementasikan pada kumpulan baris kursor set kunci, baris yang dihapus dihapus pada waktu pengambilan dan dimungkinkan untuk metode pengambilan baris, seperti GetNextRows dan GetRowsAt, untuk mengembalikan baris S_OK dan lebih sedikit daripada yang diminta. Perhatikan bahwa perilaku ini tidak menandakan kondisi DB_S_ENDOFROWSET dan bahwa jumlah baris yang dikembalikan tidak akan pernah nol jika ada baris yang tersisa. |
| DBPROP_REPORTMULTIPLECHANGES | Properti set baris ini tidak diimplementasikan oleh penyedia SQL Server Native Client OLE DB. Mencoba membaca atau menulis nilai properti menghasilkan kesalahan. |
| DBPROP_RETURNPENDINGINSERTS | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Ketika metode yang mengambil baris dipanggil, penyedia SQL Server Native Client OLE DB tidak mengembalikan baris sisipkan yang tertunda. |
| DBPROP_ROWRESTRICT | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Kumpulan baris penyedia SQL Server Native Client OLE DB tidak mendukung hak akses berdasarkan baris. Jika antarmuka IRowsetChange diekspos pada set baris, metode SetData dapat dipanggil oleh konsumen. |
| DBPROP_ROWSET_ASYNCH | R/W: Baca/tulis Default: 0 Deskripsi: Menyediakan pemrosesan set baris asinkron. Properti ini berada di grup properti Rowset dan kumpulan properti DBPROPSET_ROWSET. Jenisnya VT_14. Satu-satunya nilai dalam bitmask yang didukung oleh SQL Server Native Client adalah DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R/W: Baca-saja Default: DBPROPVAL_RT_FREETHREAD Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung akses ke objeknya dari beberapa utas eksekusi dari satu konsumen. |
| DBPROP_SERVERCURSOR | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Saat diatur, kursor SQL Server digunakan untuk mendukung set baris. Untuk informasi selengkapnya, lihat Kumpulan Baris dan Kursor SQL Server. |
| DBPROP_SERVERDATAONINSERT | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Data server saat disisipkan. VARIANT_TRUE: Pada saat penyisipan dikirimkan ke server, penyedia mengambil data dari server untuk memperbarui cache baris lokal. VARIANT_FALSE: Penyedia tidak mengambil nilai server untuk baris yang baru disisipkan. |
| DBPROP_STRONGIDENTITY | R/W: Baca-saja Default: VARIANT_TRUE Deskripsi: Identitas baris yang kuat. Jika sisipan diizinkan pada set baris (IRowsetChange atau IRowsetUpdate adalah true), dan DBPROP_UPDATABILITY diatur untuk mendukung InsertRows, nilai DBPROP_STRONGIDENTITY bergantung pada properti DBPROP_CHANGEINSERTEDROWS (akan VARIANT_FALSE jika nilai properti DBPROP_CHANGEINSERTEDROWS VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | R/W: Baca-saja Default: VARIANT_FALSE Deskripsi: Penyedia SQL Server Native Client OLE DB hanya mendukung objek yang ditransaksikan. Untuk mengetahui informasi selengkapnya, lihat Transformasi. |
| DBPROP_UNIQUEROWS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Baris unik. VARIANT_TRUE: Setiap baris diidentifikasi secara unik oleh nilai kolomnya. Kumpulan kolom yang secara unik mengidentifikasi baris memiliki DBCOLUMNFLAGS_KEYCOLUMN yang diatur dalam struktur DBCOLUMNINFO yang dikembalikan dari metode GetColumnInfo . VARIANT_FALSE: Baris mungkin atau mungkin tidak diidentifikasi secara unik oleh nilai kolomnya. Kolom kunci mungkin atau mungkin tidak ditandai dengan DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | R/W: Baca/tulis Default: 0 Deskripsi: Penyedia SQL Server Native Client OLE DB mendukung semua nilai DBPROP_UPDATABILITY. Pengaturan DBPROP_UPDATABILITY tidak membuat set baris yang dapat dimodifikasi. Untuk membuat set baris dapat dimodifikasi, atur DBPROP_IRowsetChange atau DBPROP_IRowsetUpdate. |
Penyedia SQL Server Native Client OLE DB menentukan kumpulan properti khusus penyedia DBPROPSET_SQLSERVERROWSET seperti yang ditunjukkan dalam tabel ini.
| ID Properti | Deskripsi |
|---|---|
| SSPROP_COLUMN_ID | Kolom: ColumnID R/W: Baca-saja Jenis: VT_U12 | VT_ARRAY Default: VT_EMPTY Deskripsi: Array nilai bilangan bulat yang mewakili posisi ordinal (berbasis 1) dari kolom hasil klausa COMPUTE dalam pernyataan T-SQL SELECT saat ini. Ini adalah penyedia SQL Server Native Client OLE DB yang setara dengan atribut SQL_CA_SS_COLUMN_ID ODBC. |
| SSPROP_DEFERPREPARE | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_TRUE Deskripsi: VARIANT_TRUE: Dalam eksekusi yang disiapkan, persiapan perintah ditangguhkan hingga ICommand::Execute dipanggil atau operasi metaproperti dilakukan. Jika properti diatur ke VARIANT_FALSE: Pernyataan disiapkan ketika ICommandPrepare::P repare dijalankan. |
| SSPROP_IRowsetFastLoad | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_FALSE Deskripsi: Atur properti ini ke VARIANT_TRUE untuk membuka kumpulan baris beban cepat melalui IOpenRowset::OpenRowset. Anda tidak dapat mengatur properti ini di ICommandProperties::SetProperties. |
| SSPROP_ISSAsynchStatus | Kolom: Tidak. R/W: Baca/tulis Jenis: VT_BOOL Default: VARIANT_FALSE Deskripsi: Atur properti ini ke VARIANT_TRUE untuk mengaktifkan operasi asinkron menggunakan antarmuka ISSAsynchStatus . |
| SSPROP_MAXBLOBLENGTH | Kolom: Tidak R/W: Baca/tulis Jenis: VT_I4 Default: Penyedia tidak membatasi ukuran teks yang dikembalikan oleh server dan nilai properti diatur ke maksimumnya. Misalnya, 2147483647. Deskripsi: Penyedia SQL Server Native Client OLE DB menjalankan pernyataan SET TEXTSIZE untuk membatasi panjang data objek besar biner (BLOB) yang dikembalikan dalam pernyataan SELECT. |
| SSPROP_NOCOUNT_STATUS | Kolom: NoCount R/W: Baca-saja Jenis: VT_BOOL Default: VARIANT_FALSE Deskripsi: Nilai boolean yang mewakili status SET NOCOUNT ON/OFF di SQL Server: VARIANT_TRUE: ketika SET NOCOUNT AKTIF VARIANT_FALSE: saat MENGATUR NOCOUNT NONAKTIF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BSTR (1-2000 karakter diizinkan) Default: String kosong Deskripsi: Teks pesan pemberitahuan kueri. Ini ditentukan pengguna, dan tidak memiliki format yang ditentukan. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Kolom: Tidak R/W: Baca/tulis Jenis: VT_BSTR Default: String kosong Deskripsi: Opsi pemberitahuan kueri. Ini ditentukan dalam string dengan name=value. Pengguna bertanggung jawab untuk membuat layanan dan membaca pemberitahuan dari antrean. Sintaksis string opsi pemberitahuan kueri adalah:service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Contohnya: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Kolom: Tidak R/W: Baca/tulis Jenis: VT_UI4 Default: 432000 detik (5 hari) Minimum: 1 detik Maksimum: 2^31-1 detik Deskripsi: Jumlah detik pemberitahuan kueri akan tetap aktif. |
Lihat Juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk