sp_cursoroption (T-SQL)

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
Adalah nilai handel yang dihasilkan oleh SQL Server dan dikembalikan oleh prosedur tersimpan sp_cursoropen. kursor memerlukan nilai input int untuk eksekusi.

code
Digunakan untuk menetapkan berbagai faktor nilai pengembalian kursor. kode memerlukan salah satu nilai input int 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). Jika nilai "0" ditetapkan, semua kolom teks dan gambar dalam daftar pemilihan akan mengembalikan penunjuk teks daripada data.
0x0002	CURSOR_NAME	Menetapkan nama yang ditentukan dalam nilai ke kursor. Ini, pada gilirannya, memungkinkan ODBC untuk menggunakan pernyataan UPDATE/DELETE berposisi Transact-SQL pada kursor yang dibuka melalui sp_cursoropen. String dapat ditentukan sebagai karakter apa pun atau jenis data Unicode. Karena pernyataan UPDATE/DELETE yang diposisikan Transact-SQL beroperasi, secara default, pada baris pertama dalam kursor lemak, sp_cursor SETPOSITION harus digunakan untuk memosisikan kursor sebelum mengeluarkan pernyataan UPDATE/DELETE yang diposisikan.
0x0003	TEXTDATA	Mengembalikan data aktual, bukan penunjuk teks, untuk kolom teks atau gambar tertentu pada pengambilan berikutnya (yaitu membatalkan efek TEXTPTR_ONLY). Jika TEXTDATA diaktifkan untuk kolom tertentu, baris diambil kembali atau disegarkan, lalu dapat diatur kembali ke TEXTPTR_ONLY. Seperti halnya TEXTPTR_ONLY, parameter nilai adalah bilangan bulat yang menentukan nomor kolom dan nilai nol mengembalikan semua kolom teks atau gambar.
0x0004	SCROLLOPT	Opsi gulir. Lihat "Nilai Kode yang Dikembalikan" nanti dalam topik ini untuk informasi tambahan.
0x0005	CCOPT	Opsi kontrol konkurensi. Lihat "Nilai Kode yang Dikembalikan" nanti dalam topik ini untuk informasi tambahan.
0x0006	ROWCOUNT	Jumlah baris yang saat ini dalam tataan hasil. Catatan: ROWCOUNT mungkin 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 nilai input kode 0x0001, 0x0002, atau 0x0003.

Catatan

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

Mengembalikan Nilai Kode

Parameter nilai dapat mengembalikan salah satu nilai kode berikut.

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

Parameter nilai mengembalikan salah satu nilai SCROLLOPT berikut.

Nilai hasil	Deskripsi
0x0001	SET KUNCI
0x0002	DINAMIS
0x0004	FORWARD_ONLY
0x0008	STATIS

Parameter nilai mengembalikan salah satu nilai CCOPT berikut.

Nilai hasil	Deskripsi
0x0001	READ_ONLY
0x0002	SCROLL_LOCKS
0x0004 atau 0x0008	OPTIMIS

Lihat Juga

Prosedur Tersimpan Sistem (Transact-SQL)
sp_cursor (T-SQL)
sp_cursoropen (T-SQL)