Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL Server
Define as opções do cursor ou retorna informações do cursor criadas pelo procedimento armazenado sp_cursoropen.
sp_cursoroption é invocado especificando ID = 8 em um pacote de fluxo de dados tabular (TDS).
Transact-SQL convenções de sintaxe
Sintaxe
sp_cursoroption cursor , code , value
[ ; ]
Argumentos
Importante
Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção de sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.
cursor
Um valor handle gerado pelo SQL Server e retornado pelo sp_cursoropen procedimento armazenado. O cursor parâmetro é int e não pode ser NULL.
código
Usado para estipular vários fatores dos valores de retorno do cursor. O código parâmetro é inte deve ser um dos seguintes valores:
| Valor | Designação | Descrição |
|---|---|---|
0x0001 |
TEXTPTR_ONLY |
Retorna o ponteiro de texto, e não os dados reais, para determinadas colunas de texto ou imagem designadas.TEXTPTR_ONLY permite que ponteiros de texto sejam usados como identificadores de para objetos de 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 valor 0 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 valor ao cursor, o que permite que o ODBC use instruções Transact-SQL posicionadas UPDATE/DELETE em cursores abertos via sp_cursoropen.A cadeia de caracteres pode ser especificada como qualquer caractere ou tipo de dados Unicode. Como Transact-SQL instruções posicionadas UPDATE/DELETE operam, por padrão, na primeira linha de um cursor gordo, sp_cursor SETPOSITION deve ser usado para posicionar o cursor antes de emitir a instrução UPDATE/DELETE posicionada. |
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á rebuscada ou atualizada e poderá ser redefinida para TEXTPTR_ONLY. Assim como TEXTPTR_ONLY, o parâmetro value é um 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 Valores de código de retorno. |
0x0005 |
CCOPT |
Opção de controle de simultaneidade. Para obter mais informações, consulte Valores de código de retorno. |
0x0006 |
ROWCOUNT |
O número de linhas atualmente no conjunto de resultados. Nota: 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 é retornado se o número de linhas for desconhecido. |
valor
Designa o valor retornado por código.
valor é um parâmetro necessário que requer um código 0x0001, 0x0002ou 0x0003 valor de entrada.
Um código valor de 2 é um tipo de dados de cadeia de caracteres. Qualquer outro código valor inserido ou retornado por valor é um int.
Valores de código de retorno
O valor parâmetro pode retornar um dos seguintes códigos valores.
| Valor de retorno | Descrição |
|---|---|
0x0004 |
SCROLLOPT |
0X0005 |
CCOPT |
0X0006 |
ROWCOUNT |
O valor parâmetro retorna um dos seguintes valores de SCROLLOPT.
| Valor de retorno | Descrição |
|---|---|
0x0001 |
KEYSET |
0x0002 |
DYNAMIC |
0x0004 |
FORWARD_ONLY |
0x0008 |
STATIC |
O valor parâmetro retorna um dos seguintes valores de CCOPT.
| Valor de retorno | Descrição |
|---|---|
0x0001 |
READ_ONLY |
0x0002 |
SCROLL_LOCKS |
0x0004 or 0x0008 |
OPTIMISTIC |