Share via


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).

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

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.

    NotaNota
    Si 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