sp_cursoroption (Transact-SQL)

Aplica-se: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_cursoroption cursor , code , value
[ ; ]

Argumentos

cursor

Um handle valor gerado pelo SQL Server e retornado pelo sp_cursoropen procedimento armazenado. O parâmetro cursor é int e não pode ser NULL.

code

Usado para estipular vários fatores dos valores de retorno de cursor. O parâmetro code é int e deve ser um dos seguintes valores:

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 ponteiros de texto sejam usados como identificadores para objetos blob que podem ser recuperados ou atualizados seletivamente posteriormente usando recursos Transact-SQL ou DBLIB (por exemplo, Transact-SQL READTEXT ou DBLIB DBWRITETEXT).
Se um 0 valor for atribuído, todas as colunas de texto e imagem na lista de seleção retornarão ponteiros de texto em vez de dados.
0x0002 CURSOR_NAME Atribui o nome especificado em value ao cursor, o que permite que o ODBC use instruções posicionadasDELETE UPDATE/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 posicionadas UPDATE/DELETE do Transact-SQL operam, por padrão, na primeira linha em um cursor gordo, sp_cursor SETPOSITION devem ser usadas para posicionar o cursor antes de emitir a instrução posicionada.UPDATE/DELETE
0x0003 TEXTDATA Retorna os dados reais, não o ponteiro de texto, para determinadas colunas de texto ou imagem em buscas subsequentes (ou seja, isso desfaz o efeito de TEXTPTR_ONLY).

Se TEXTDATA estiver habilitado para uma coluna específica, a linha será buscada novamente ou atualizada e poderá ser definida novamente para TEXTPTR_ONLY. Assim como acontece com TEXTPTR_ONLY, o parâmetro value é um número inteiro que especifica o número da coluna e um valor zero retorna todas as colunas de texto ou imagem.
0x0004 SCROLLOPT Opção de rolagem. Para obter mais informações, consulte Retornar valores de código.
0x0005 CCOPT Opção de controle de simultaneidade. Para obter mais informações, consulte Retornar valores de código.
0x0006 ROWCOUNT O número de linhas atualmente no conjunto de resultados.

Observação: o ROWCOUNT pode 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 pelo código. value é um parâmetro necessário que chama um 0x0001valor de entrada , 0x0002, ou 0x0003 code .

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

Valores do código de retorno

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

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

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

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

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

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