CursorType, propriété (ADO)

Indique le type de curseur utilisé dans un objet Recordset.

Paramètres et valeurs de retour

Définit ou retourne une valeur CursorTypeEnum . La valeur par défaut est adOpenForwardOnly.

Notes

Utilisez la propriété CursorType pour spécifier le type de curseur à utiliser lors de l’ouverture de l’objet Recordset .

Seul un paramètre d’adOpenStatic est pris en charge si la propriété CursorLocation est définie sur adUseClient. Si une valeur non prise en charge est définie, il n'y aura pas d'erreur ; le CursorType pris en charge le plus proche sera utilisé à la place.

Si un fournisseur ne prend pas en charge le type de curseur demandé, il peut retourner un autre type de curseur. La propriété CursorType change pour correspondre au type de curseur réel utilisé lorsque l’objet Recordset est ouvert. Pour vérifier des fonctionnalités spécifiques du curseur retourné, utilisez la méthode Supports . Une fois que vous fermez le Recordset, la propriété CursorType revient à son paramètre d’origine.

Le graphique suivant montre les fonctionnalités du fournisseur (identifiées par les constantes de méthode Supports ) requises pour chaque type de curseur.

Pour un Recordset de ce CursorType	La méthode Supports doit retourner True pour toutes ces constantes
adOpenForwardOnly	Aucun
adOpenKeyset	adBookmark, adHoldRecords, adMovePrevious, adResync
adOpenDynamic	adMovePrevious
adOpenStatic	adBookmark, adHoldRecords, adMovePrevious, adResync

Notes

Bien que Supports(adUpdateBatch) soit vrai pour les curseurs dynamiques et en avant uniquement, pour les mises à jour par lots, vous devez utiliser un ensemble de clés ou un curseur statique. Définissez la propriété LockType sur adLockBatchOptimistic et la propriété CursorLocation sur adUseClient pour activer le service de curseur pour OLE DB, requis pour les mises à jour par lots.

La propriété CursorType est en lecture/écriture lorsque l’objet Recordset est fermé et en lecture seule lorsqu’il est ouvert.

Notes

Utilisation du service de données à distance Lorsqu’elle est utilisée sur un objet Recordset côté client, la propriété CursorType ne peut être définie que sur adOpenStatic.

S'applique à

Recordset, objet (ADO)

Voir aussi

Exemple de propriétés CursorType, LockType et EditMode (VB)
Exemple de propriétés CursorType, LockType et EditMode (VC++)
Supports, méthode