sp_cursoroption (Transact-SQL)
Establece las opciones de cursor o devuelve información del cursor que crea el procedimiento almacenado sp_cursoropen. sp_cursoroption se invoca especificando el identificador 8 en un paquete de flujo de datos tabular (TDS).
Sintaxis
sp_cursoroption
cursor
,
code
,
value
Argumentos
cursor
Es un valor de identificador generado por SQL Server que devuelve el procedimiento almacenado sp_cursoropen. cursor require un valor de entrada int para la ejecución.code
Se usa para estipular varios factores de los valores devueltos del cursor. El parámetro code requiere uno de los valores de entrada int siguientes: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 utilizar los punteros de texto como identificadores para objetos blob que se pueden recuperar o actualizarse selectivamente después utilizando medios de Transact-SQL o DBLIB (como READTEXT o DBLIB DBWRITETEXT de Transact-SQL).
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 value al cursor. Esto, a su vez, permite a ODBC usar instrucciones UPDATE o DELETE posicionadas 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 UPDATE o DELETE posicionadas de Transact-SQL operan en la primera fila de un cursor grueso de forma predeterminada, sp_cursor SETPOSITION se debe usar para colocar el cursor antes de emitir la instrucción UPDATE o 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.
NotaSi se usa el rellenado asincrónico, ROWCOUNT puede haber cambiado del valor que devuelve sp_cursoropen. Se devuelve el valor -1 si se desconoce el número de filas.value
Designa el valor que devuelve el parámetro code. El parámetro value es un parámetro necesario que requiere un valor de entrada de code 0x0001, 0x0003 o 0x0002.Nota
El valor 2 de code es un tipo de datos de cadena. Cualquier otro valor code de entrada o devuelto por value es un entero.
Valores del código de retorno
El parámetro value puede devolver uno de los siguientes valores code.
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 CCOPT.
Valor devuelto |
Descripción |
---|---|
0x0001 |
READ_ONLY |
0x0002 |
SCROLL_LOCKS |
0x0004 o 0x0008 |
OPTIMISTIC |
Vea también