Bagikan melalui

sp_cursoroption (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

Mengatur opsi kursor atau mengembalikan informasi kursor yang dibuat oleh prosedur tersimpan sp_cursoropen . sp_cursoroption dipanggil dengan menentukan ID = 8 dalam paket aliran data tabular (TDS).

Konvensi sintaks transact-SQL

Sintaks

sp_cursoroption cursor , code , value
[ ; ]

Argumen

Kursor

handle Nilai yang dihasilkan oleh SQL Server, dan dikembalikan oleh prosedur tersimpansp_cursoropen. Parameter kursor adalah int dan tidak boleh NULL.

code

Digunakan untuk menetapkan berbagai faktor nilai pengembalian kursor. Parameter kode adalah int, dan harus menjadi salah satu nilai berikut:

Nilai Nama Deskripsi
0x0001 TEXTPTR_ONLY Mengembalikan penunjuk teks, dan bukan data aktual, untuk kolom teks atau gambar tertentu yang ditunjuk.

TEXTPTR_ONLY memungkinkan penunjuk teks digunakan sebagai handel ke objek blob yang nantinya dapat diambil atau diperbarui secara selektif menggunakan fasilitas Transact-SQL atau DBLIB (misalnya, Transact-SQL READTEXT atau DBLIB DBWRITETEXT).
0 Jika nilai ditetapkan, semua kolom teks dan gambar dalam daftar pilih mengembalikan penunjuk teks daripada data.
0x0002 CURSOR_NAME Menetapkan nama yang ditentukan dalam nilai ke kursor, yang memungkinkan ODBC menggunakan pernyataan berposisiDELETE UPDATE/Transact-SQL pada kursor yang dibuka melalui .sp_cursoropen

String dapat ditentukan sebagai karakter apa pun atau jenis data Unicode.
Karena pernyataan yang diposisikan Transact-SQL beroperasi, secara default, pada baris pertama dalam kursor lemak, sp_cursor SETPOSITION harus digunakan untuk memosisikan kursor sebelum mengeluarkan pernyataan yang diposisikan/UPDATEDELETE.UPDATE/DELETE
0x0003 TEXTDATA Mengembalikan data aktual, bukan penunjuk teks, untuk kolom teks atau gambar tertentu pada pengambilan berikutnya (artinya, ini membatalkan efek TEXTPTR_ONLY).

Jika TEXTDATA diaktifkan untuk kolom tertentu, baris diambil kembali atau di-refresh, dan kemudian dapat diatur kembali ke TEXTPTR_ONLY. TEXTPTR_ONLYSeperti halnya , parameter nilai adalah bilangan bulat yang menentukan nomor kolom dan nilai nol mengembalikan semua kolom teks atau gambar.
0x0004 SCROLLOPT Opsi gulir. Untuk informasi selengkapnya, lihat Mengembalikan nilai kode.
0x0005 CCOPT Opsi kontrol konkurensi. Untuk informasi selengkapnya, lihat Mengembalikan nilai kode.
0x0006 ROWCOUNT Jumlah baris yang saat ini dalam tataan hasil.

Catatan: mungkin ROWCOUNT telah berubah sejak nilai yang dikembalikan oleh sp_cursoropen jika populasi asinkron sedang digunakan. Nilai -1 dikembalikan jika jumlah baris tidak diketahui.

value

Menunjuk nilai yang dikembalikan oleh kode. nilai adalah parameter yang diperlukan yang memanggil 0x0001nilai input kode , , 0x0002atau 0x0003 .

Nilai kode adalah 2 jenis data string. Input nilai kode lainnya atau dikembalikan oleh nilai adalah int.

Mengembalikan nilai kode

Parameter nilai mungkin mengembalikan salah satu nilai kode berikut.

Nilai hasil Deskripsi
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Parameter nilai mengembalikan salah satu nilai berikut SCROLLOPT .

Nilai hasil Deskripsi
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Parameter nilai mengembalikan salah satu nilai berikut CCOPT .

Nilai hasil Deskripsi
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

Konten terkait