sp_cursoroption (Transact-SQL)
S'applique à : SQL Server
Définit les options de curseur ou retourne les informations de curseur créées par la procédure stockée sp_cursoropen. sp_cursoroption est appelée en spécifiant l’ID =8 dans un paquet TDS (Tabular Data Stream).
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_cursoroption cursor, code, value
Arguments
cursor
Valeur de handle générée par SQL Server et retournée par la procédure stockée sp_cursoropen. le curseur nécessite une valeur d’entrée int pour l’exécution.
code
Permet de stipuler différents facteurs des valeurs de retour de curseur. Le code nécessite 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 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 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 | Attribue le nom spécifié dans la valeur au curseur. Cela permet à ODBC d’utiliser des instructions UPDATE/DELETE positionnées par 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 UPDATE/DELETE positionnées sur Transact-SQL fonctionnent, par défaut, sur la première ligne d’un curseur gras, 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. Remarque : RowCOUNT 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 valeur d’entrée de code 0x0001, 0x0002 ou 0x0003.
Remarque
Une valeur de code de 2 est un type de données de chaîne. Toute autre entrée de valeur de code ou retournée par valeur est un entier.
Codet de retour
Le paramètre valeur peut retourner 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 SCROLLOPT suivantes.
Valeur retournée | Description |
---|---|
0x0001 | KEYSET |
0x0002 | DYNAMIC |
0x0004 | FORWARD_ONLY |
0x0008 | STATIC |
Le paramètre valeur retourne l’une des valeurs CCOPT suivantes.
Valeur retournée | Description |
---|---|
0x0001 | READ_ONLY |
0x0002 | SCROLL_LOCKS |
0x0004 ou 0x0008 | OPTIMISTIC |
Voir aussi
Procédures stockées système (Transact-SQL)
sp_cursor (Transact-SQL)
sp_cursoropen (Transact-SQL)
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour