sp_cursoroption (Transact-SQL)

Se aplica a:SQL Server

Establece opciones de cursor o devuelve información de cursor creada por el procedimiento almacenado sp_cursoropen. 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
Es un valor de identificador generado por SQL Server y devuelto por el procedimiento almacenado sp_cursoropen. el cursor requiere un valor de entrada int para su ejecución.

code
Se usa para estipular varios factores de los valores devueltos del cursor. el código requiere uno de los siguientes valores de entrada int :

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 usar punteros de texto 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 el valor "0", todas las columnas de imagen y texto de la lista de selección devolverán punteros de texto en lugar de datos.
0x0002	CURSOR_NAME	Asigna el nombre especificado en el valor al cursor. Esto, a su vez, permite a ODBC usar instrucciones UPDATE/DELETE posicionadas de Transact-SQL en cursores abiertos a través de sp_cursoropen. La cadena se puede especificar como cualquier tipo de datos Unicode o de caracteres. Puesto que las instrucciones UPDATE/DELETE posicionadas de Transact-SQL funcionan, de forma predeterminada, en la primera fila de un cursor fat, se debe usar sp_cursor SETPOSITION para colocar el cursor antes de emitir la instrucción UPDATE/DELETE posicionada.
0x0003	TEXTDATA	Devuelve los datos reales, no el puntero de texto, para ciertas columnas de imagen o texto en las capturas siguientes (es decir, se deshace el efecto de TEXTPTR_ONLY). Si TEXTDATA está habilitado para una columna en particular, la fila se vuelve a capturar o actualizar, y puede establecerse a continuación de nuevo en TEXTPTR_ONLY. Como con TEXTPTR_ONLY, el parámetro de valor es un entero que especifica el número de columnas y un valor cero devuelve todas las columnas de texto o imagen.
0x0004	SCROLLOPT	Opción de desplazamiento. Vea "Valores del código de retorno", posteriormente en este tema, para obtener información adicional.
0x0005	CCOPT	Opción de control de simultaneidad. Vea "Valores del código de retorno", posteriormente en este tema, para obtener información adicional.
0x0006	ROWCOUNT	El número de filas que están actualmente en el conjunto de resultados. Nota: ROWCOUNT puede haber 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 un valor de entrada de código 0x0001, 0x0002 o 0x0003.

Nota

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

Valores de código de retorno

El parámetro value puede 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 siguientes valores SCROLLOPT.

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

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

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

Consulte también

Procedimientos almacenados del sistema (Transact-SQL)
sp_cursor (Transact-SQL)
sp_cursoropen (Transact-SQL)