sp_cursoroption (Transact-SQL)
適用於:SQL Server
設定數據指標選項,或傳回sp_cursoropen預存程式所建立的數據指標資訊。 sp_cursoroption是在表格式數據流 (TDS) 封包中指定 ID =8 來叫用。
語法
sp_cursoroption cursor, code, value
引數
cursor
這是 SQL Server 產生的句柄值,並由sp_cursoropen預存程式傳回。 cursor 需要 int 輸入值來執行。
code
用來規定數據指標傳回值的各種因素。 程式代碼 需要下列 其中一個 int 輸入值:
值 | 名稱 | 描述 |
---|---|---|
0x0001 | TEXTPTR_ONLY | 傳回特定指定文字或影像數據行的文字指標,而非實際數據。 TEXTPTR_ONLY允許文字指標做為 Blob 物件的句柄 ,這些物件稍後可以使用 Transact-SQL 或 DBLIB 設施選擇性地擷取或更新這些物件(例如 Transact-SQL READTEXT 或 DBLIB DBWRITETEXT)。 如果已指派 「0」 值,則選取清單中的所有文字和影像數據行都會傳回文字指標,而不是數據。 |
0x0002 | CURSOR_NAME | 將值中指定的名稱指派給數據指標。 這反過來又允許 ODBC 在透過sp_cursoropen開啟的數據指標上使用 Transact-SQL 定位 UPDATE/DELETE 語句。 字串可以指定為任何字元或 Unicode 資料類型。 由於 Transact-SQL 定位 UPDATE/DELETE 語句預設會在 fat 數據指標的第一個數據列上運作,sp_cursor SETPOSITION 應該用來在發出定位的 UPDATE/DELETE 語句之前放置數據指標。 |
0x0003 | TEXTDATA | 傳回後續擷取上特定文字或影像數據行的實際數據,而非文字指標(也就是這會復原TEXTPTR_ONLY的效果)。 如果特定數據行已啟用 TEXTDATA,數據列會重新擷取或重新整理,然後可以設定回TEXTPTR_ONLY。 如同TEXTPTR_ONLY,value 參數是一個整數,指定數據行編號,而零值會傳回所有文字或影像數據行。 |
0x0004 | SCROLLOPT | 捲動選項。 如需詳細資訊,請參閱本主題稍後的。 |
0x0005 | CCOPT | 並行控制選項。 如需詳細資訊,請參閱本主題稍後的。 |
0x0006 | ROWCOUNT | 結果集中目前的數據列數目。 注意:如果正在使用異步母體擴展,則ROWCOUNT可能已經變更,因為sp_cursoropen傳回的值。 如果數據列數目未知,則會傳回 -1 值。 |
value
指定程式代碼傳回的值。 value 是呼叫0x0001、0x0002或0x0003 程式代碼 輸入值的必要參數。
注意
代碼值為 2 是字串資料類型。 任何其他 程式代碼 值輸入或傳 回的值 都是整數。
傳回碼值
value 參數可能會傳回下列其中一個程式代碼值。
傳回值 | 描述 |
---|---|
0x0004 | SCROLLOPT |
0X0005 | CCOPT |
0X0006 | ROWCOUNT |
value 參數會傳回下列其中一個 SCROLLOPT 值。
傳回值 | 描述 |
---|---|
0x0001 | KEYSET |
0x0002 | DYNAMIC |
0x0004 | FORWARD_ONLY |
0x0008 | STATIC |
value 參數會傳回下列其中一個 CCOPT 值。
傳回值 | 描述 |
---|---|
0x0001 | READ_ONLY |
0x0002 | SCROLL_LOCKS |
0x0004或0x0008 | OPTIMISTIC |
另請參閱
系統預存程序 (Transact-SQL)
sp_cursor (Transact-SQL)
sp_cursoropen (Transact-SQL)
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應