sp_cursoroption (Transact-SQL)

Define opções de cursor ou retorna informações de cursor criadas pelo procedimento armazenado sp_cursoropen. sp_cursoroption é invocado especificando-se ID = 8 em um pacote TDS.

Convenções de sintaxe Transact-SQL

Sintaxe

        sp_cursoroption 
        cursor
        , 
        code
        , 
        value
      

Argumentos

• cursor
  É um valor de identificador gerado pelo SQL Server e retornado pelo procedimento armazenado sp_cursoropen. cursor requer um valor de entrada int para execução. 

• code
  Usado para estipular vários fatores dos valores de retorno de cursor. code requer um dos seguintes valores de entrada int:

  Valor	Nome	Descrição
  0x0001	TEXTPTR_ONLY	Retorna o ponteiro de texto, e não os dados reais, para certos textos designados ou colunas de imagem. TEXTPTR_ONLY permite usar ponteiros de texto como identificadores para objetos blob que podem ser recuperados seletivamente ou atualizados com o uso de Transact-SQL ou instalações DBLIB (por exemplo, Transact-SQL READTEXT ou DBLIB DBWRITETEXT). Se um valor "0" for atribuído, todas as colunas de texto e imagem na lista selecionada retornarão ponteiros de texto, em vez de dados.
  0x0002	CURSOR_NAME	Atribui o nome especificado em value ao cursor. Esse, por sua vez, permite ao ODBC usar instruções UPDATE/DELETE posicionadas Transact-SQL em cursores abertos via sp_cursoropen. É possível especificar a cadeia de caracteres como qualquer tipo de dados de caractere ou Unicode. Como as instruções UPDATE/DELETE posicionadas Transact-SQL operam, por padrão, na primeira linha em um cursor fat, sp_cursor SETPOSITION deve ser usado para posicionar o cursor antes da emissão da instrução UPDATE/DELETE posicionada.
  0x0003	TEXTDATA	Retorna os dados reais, não o ponteiro de texto, para certas colunas de texto ou imagem em buscas subsequentes (isto é, desfaz o efeito de TEXTPTR_ONLY). Se TEXTDATA for habilitado para uma coluna específica, a linha será buscada novamente ou atualizada e poderá ser definida outra vez como TEXTPTR_ONLY. Assim como ocorre com TEXTPTR_ONLY, o parâmetro de valor é um inteiro que especifica o número da coluna e um valor de zero retorna todas as colunas de texto ou imagem.
  0x0004	SCROLLOPT	Opção de rolagem. Consulte "Valores de códigos retornados" posteriormente neste tópico para obter informações adicionais.
  0x0005	CCOPT	Opção de controle de simultaneidade. Consulte "Valores de códigos retornados" posteriormente neste tópico para obter informações adicionais.
  0x0006	ROWCOUNT	O número de linhas atualmente no conjunto de resultados. Observação ROWCOUNT poderá ter sido alterado desde o valor retornado por sp_cursoropen se a população assíncrona estiver sendo usada. O valor –1 será retornado se o número de linhas for desconhecido.

• value
  Designa o valor retornado por code. value é um parâmetro necessário que requer um valor de entrada code 0x0001, 0x0002 ou 0x0003.

  Observação
  Um valor code de 2 é um tipo de dados string. Qualquer outra entrada de valor code ou retornada por value é um número inteiro.

Valores de códigos de retorno

O parâmetro value pode retornar um dos valores code a seguir.

Valor de retorno	Descrição
0x0004	SCROLLOPT
0X0005	CCOPT
0X0006	ROWCOUNT

O parâmetro value retorna um dos valores SCROLLOPT a seguir.

Valor de retorno	Descrição
0x0001	KEYSET
0x0002	DYNAMIC
0x0004	FORWARD_ONLY
0x0008	STATIC

O parâmetro value retorna um dos valores CCOPT a seguir.

Valor de retorno	Descrição
0x0001	READ_ONLY
0x0002	SCROLL_LOCKS
0x0004 ou 0x0008	OPTIMISTIC

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

Outros recursos

sp_cursor (Transact-SQL)

sp_cursoropen (Transact-SQL)