sp_cursoroption (Transact-SQL)

S’applique à : SQL Server

Définit les options de curseur ou retourne les informations de curseur créées par la sp_cursoropen procédure stockée. sp_cursoroption est appelé en spécifiant ID = 8 dans un paquet TDS (Tabular Data Stream).

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_cursoroption cursor , code , value
[ ; ]

Arguments

cursor

Valeur handle générée par SQL Server et retournée par la sp_cursoropen procédure stockée. Le paramètre de curseur est int et ne peut pas être NULL.

code

Permet de stipuler différents facteurs des valeurs de retour de curseur. Le paramètre de code est int et doit être l’une des valeurs suivantes :

Valeur Nom Description
0x0001 TEXTPTR_ONLY Retourne le pointeur de texte, et non les données réelles, pour certaines colonnes text ou image désignées.

TEXTPTR_ONLY permet aux pointeurs de texte d’être utilisés comme handles vers des objets blob qui peuvent ultérieurement être récupérés ou mis à jour de manière sélective à l’aide des installations Transact-SQL ou DBLIB (par exemple, Transact-SQL READTEXT ou DBLIB DBWRITETEXT).
Si une 0 valeur est affectée, toutes les colonnes de texte et d’image de la liste de sélection retournent des pointeurs de texte plutôt que des données.
0x0002 CURSOR_NAME Affecte le nom spécifié en valeur au curseur, ce qui permet à ODBC d’utiliser des instructions positionnées UPDATE/DELETE Transact-SQL sur les curseurs ouverts via .sp_cursoropen

La chaîne peut être spécifiée comme tout caractère ou type de données Unicode.
Étant donné que les instructions positionnées UPDATE/DELETE transact-SQL fonctionnent, par défaut, sur la première ligne d’un curseur gras, sp_cursor SETPOSITION doivent être utilisées pour positionner le curseur avant d’émettre l’instruction positionnée.UPDATE/DELETE
0x0003 TEXTDATA Retourne les données réelles, et non le pointeur de texte, pour certaines colonnes de texte ou d’image sur les extractions suivantes (autrement dit, cela annule l’effet de TEXTPTR_ONLY).

Si TEXTDATA elle est activée pour une colonne particulière, la ligne est reféchée ou actualisée et peut ensuite être rétablie TEXTPTR_ONLY. Comme avec TEXTPTR_ONLY, le paramètre valeur est un entier qui spécifie le numéro de colonne et une valeur zéro retourne toutes les colonnes de texte ou d’image.
0x0004 SCROLLOPT Option de défilement. Pour plus d’informations, consultez Les valeurs de code de retour.
0x0005 CCOPT Option de contrôle en matière d'accès concurrentiel. Pour plus d’informations, consultez Les valeurs de code de retour.
0x0006 ROWCOUNT Nombre de lignes actuellement dans le jeu de résultats.

Remarque : La ROWCOUNT valeur peut avoir changé depuis que la valeur retournée par sp_cursoropen si la population asynchrone est utilisée. La valeur -1 est retournée si le nombre de lignes est inconnu.

value

Désigne la valeur retournée par le code. la valeur est un paramètre obligatoire qui appelle une 0x0001valeur d’entrée de code, ou 0x0003 une 0x0002valeur d’entrée de code.

Une valeur de code est un type de 2 données de chaîne. Toute autre entrée de valeur de code ou retournée par valeur est un int.

Valeurs des codes de retour

Le paramètre valeur peut renvoyer l’une des valeurs de code suivantes.

Valeur retournée Description
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Le paramètre valeur retourne l’une des valeurs suivantes SCROLLOPT .

Valeur retournée Description
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Le paramètre valeur retourne l’une des valeurs suivantes CCOPT .

Valeur retournée Description
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC