sp_cursoroption (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Establece opciones de cursor o devuelve información del cursor creada por el sp_cursoropen procedimiento almacenado. sp_cursoroption se invoca especificando ID = 8 en un paquete de flujo de datos tabular (TDS).

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_cursoroption cursor , code , value
[ ; ]

Argumentos

cursor

Valor handle generado por SQL Server y devuelto por el sp_cursoropen procedimiento almacenado. El parámetro cursor es int y no puede ser NULL.

code

Se usa para estipular varios factores de los valores devueltos del cursor. El parámetro de código es int y debe ser uno de los siguientes valores:

Valor Nombre Descripción
0x0001 TEXTPTR_ONLY Devuelve el puntero de texto y no los datos reales, para ciertas columnas de imagen o texto designado.

TEXTPTR_ONLY permite que los punteros de texto se usen como identificadores para objetos de blob que posteriormente se pueden recuperar o actualizar de forma selectiva mediante las instalaciones de Transact-SQL o DBLIB (por ejemplo, Transact-SQL READTEXT o DBLIB DBWRITETEXT).
Si se asigna un 0 valor, todas las columnas de texto e imagen de la lista de selección devuelven punteros de texto en lugar de datos.
0x0002 CURSOR_NAME Asigna el nombre especificado en el valor al cursor, que permite a ODBC usar instrucciones posicionadasDELETE UPDATE/de Transact-SQL en los cursores abiertos a través de .sp_cursoropen

La cadena se puede especificar como cualquier tipo de datos Unicode o de caracteres.
Dado que las instrucciones posicionadas UPDATE/DELETE de Transact-SQL funcionan, de forma predeterminada, en la primera fila de un cursor fat, sp_cursor SETPOSITION se deben usar para colocar el cursor antes de emitir la instrucción posicionada.UPDATE/DELETE
0x0003 TEXTDATA Devuelve los datos reales, no el puntero de texto, para determinadas columnas de texto o imagen en las capturas posteriores (es decir, deshace el efecto de TEXTPTR_ONLY).

Si TEXTDATA está habilitado para una columna determinada, la fila se vuelve a capturar o actualiza y, a continuación, se puede volver a establecer en TEXTPTR_ONLY. Al igual que con TEXTPTR_ONLY, el parámetro value es un entero que especifica el número de columna y un valor cero devuelve todas las columnas de texto o imagen.
0x0004 SCROLLOPT Opción de desplazamiento. Para obtener más información, vea Devolver valores de código.
0x0005 CCOPT Opción de control de simultaneidad. Para obtener más información, vea Devolver valores de código.
0x0006 ROWCOUNT El número de filas que están actualmente en el conjunto de resultados.

Nota: ROWCOUNT Es posible que haya cambiado desde que se usa el valor devuelto por sp_cursoropen si se usa el rellenado asincrónico. El valor -1 se devuelve si se desconoce el número de filas.

value

Designa el valor devuelto por código. value es un parámetro necesario que llama a para un 0x0001valor de entrada de código , 0x0002o 0x0003 .

Un valor de código de es un tipo de 2 datos de cadena. Cualquier otra entrada de valor de código o devuelta por value es un valor int.

Valores de código de retorno

El parámetro value podría devolver uno de los siguientes valores de código .

Valor devuelto Descripción
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

El parámetro value devuelve uno de los valores siguientes SCROLLOPT .

Valor devuelto Descripción
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

El parámetro value devuelve uno de los valores siguientes CCOPT .

Valor devuelto Descripción
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

Contenido relacionado