共用方式為

sp_cursoroption （Transact-SQL）

  • 發行項

適用於：SQL Server

設定數據指標選項，或傳回預存程式所建立的數據 sp_cursoropen 指標資訊。 sp_cursoroption 是在表格式資料流 （TDS） 封包中指定 ID = 8 來叫用。

Transact-SQL 語法慣例

語法

sp_cursoroption cursor , code , value
[ ; ]

引數

cursor

handle SQL Server 所產生的值，並由預存程式傳sp_cursoropen回。 資料 指標 參數為 int ，不能為 NULL。

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 定位DELETEUPDATE/語句。

字串可以指定為任何字元或 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 是呼叫、 0x0002或 0x0003 程式代碼輸入值的必要0x0001參數。

的程式 代碼 值 2 是字串數據類型。 任何其他 程式代碼 值輸入或傳 回的值 都是 int。

傳回碼值

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 or 0x0008 OPTIMISTIC

相關內容