sp_cursoroption (Transact-SQL)
Définit des options de curseur ou retourne des informations de curseur créées par la procédure stockée sp_cursoropen. sp_cursoroption est appelé en spécifiant ID = 8 dans un paquet TDS (Tabular Data Stream).
Syntaxe
sp_cursoroption
cursor
,
code
,
value
Arguments
cursor
Valeur de handle qui est générée par SQL Server et retournée par la procédure stockée sp_cursoropen. cursor requiert une valeur d'entrée int pour l'exécution.code
Permet de stipuler différents facteurs des valeurs de retour de curseur. code requiert l'une des valeurs d'entrée int 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 l'utilisation de pointeurs de texte comme handles vers des objets blob qui peuvent être ensuite récupérés ou mis à jour de façon sélective à l'aide de Transact-SQL ou de fonctions DBLIB (par exemple, Transact-SQL READTEXT ou DBLIB DBWRITETEXT).
Si une valeur « 0 » est affectée, toutes les colonnes text et image dans la liste de sélection retourneront des pointeurs de texte plutôt que des données.
0x0002
CURSOR_NAME
Affecte le nom spécifié dans value au curseur. ODBC peut ainsi utiliser des instructions Transact-SQL UPDATE/DELETE positionnées 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 Transact-SQL UPDATE/DELETE positionnées fonctionnent, par défaut, sur la première ligne dans un curseur fat, sp_cursor SETPOSITION doit être utilisé pour positionner le curseur avant d'émettre l'instruction UPDATE/DELETE positionnée.
0x0003
TEXTDATA
Retourne les données réelles, et non le pointeur de texte, pour certaines colonnes text ou image sur les extractions suivantes (autrement dit, cela annule l'effet de TEXTPTR_ONLY).
Si TEXTDATA est activé pour une colonne particulière, la ligne est à nouveau extraite ou actualisée, et TEXTPTR_ONLY peut ensuite lui être à nouveau affecté. Comme avec TEXTPTR_ONLY, le paramètre de valeur est un entier qui spécifie le numéro de colonne et une valeur zéro retourne toutes les colonnes text et image.
0x0004
SCROLLOPT
Option de défilement. Pour plus d'informations, consultez « Valeurs des codes de retour » plus loin dans cette rubrique.
0x0005
CCOPT
Option de contrôle en matière d'accès concurrentiel. Pour plus d'informations, consultez « Valeurs des codes de retour » plus loin dans cette rubrique.
0x0006
ROWCOUNT
Nombre de lignes actuellement dans le jeu de résultats.
RemarqueLa valeur ROWCOUNT peut avoir changé depuis la valeur retournée par sp_cursoropen si l'alimentation 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 code. value est un paramètre obligatoire qui appelle une valeur d'entrée code 0x0001, 0x0002 ou 0x0003.Notes
La valeur code 2 est un type de données de chaîne. Toute autre valeur code entrée ou retournée par value est un entier.
Valeurs des codes de retour
Le paramètre value peut retourner l'une des valeurs code suivantes.
Valeur de retour |
Description |
---|---|
0x0004 |
SCROLLOPT |
0X0005 |
CCOPT |
0X0006 |
ROWCOUNT |
Le paramètre value retourne l'une des valeurs SCROLLOPT suivantes.
Valeur de retour |
Description |
---|---|
0x0001 |
KEYSET |
0x0002 |
DYNAMIC |
0x0004 |
FORWARD_ONLY |
0x0008 |
STATIC |
Le paramètre value retourne l'une des valeurs CCOPT suivantes.
Valeur de retour |
Description |
---|---|
0x0001 |
READ_ONLY |
0x0002 |
SCROLL_LOCKS |
0x0004 ou 0x0008 |
OPTIMISTIC |
Voir aussi