sp_cursoroption (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis)

Define opções de cursor ou retorna informações de cursor criadas pelo sp_cursoropen procedimento armazenado. sp_cursoroption é invocado especificando a ID =8 em um pacote TDS (fluxo de dados tabular).

Ícone de link do tópico Convenções da sintaxe Transact-SQL

Sintaxe

  
sp_cursoroption cursor, code, value  

Argumentos

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

code
Usado para estipular vários fatores dos valores de retorno de cursor. O código 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 que os ponteiros de texto sejam usados como alças para objetos de blob que posteriormente podem ser recuperados ou atualizados seletivamente usando instalações ou Transact-SQL DBLIB (por exemplo, READTEXT ou Transact-SQL 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 no valor ao cursor. Isso, por sua vez, permite que o ODBC use instruções UPDATE/DELETE posicionadas em cursores abertos Transact-SQL por meio de 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 operam, por padrão, na primeira linha em um cursor fat, o sp_cursor SETPOSITION deve ser usado para posicionar o cursor antes de emissão da instrução Transact-SQL 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: a ROWCOUNT pode ter sido alterada desde que o valor retornado 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 pelo código. value é um parâmetro necessário que chama um valor de 0x0001, 0x0002 ou 0x0003 de código.

Observação

Um valor de código de 2 é um tipo de dados de cadeia de caracteres. Qualquer outra entrada de valor de código ou retornada por valor é um inteiro.

Valores do código de retorno

O parâmetro value pode retornar um dos valores de código a seguir.

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

O parâmetro value retorna um dos seguintes valores SCROLLOPT.

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

O parâmetro value retorna um dos seguintes valores CCOPT.

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

Consulte Também

Procedimentos armazenados do sistema (Transact-SQL)
sp_cursor (Transact-SQL)
sp_cursoropen (Transact-SQL)