DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés HFSQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
OptionsCurseur (Propriété)
En anglais : CursorOptions
OLE DBConnecteurs Natifs (Accès Natifs)Disponible uniquement avec ces types de connexion
La propriété OptionsCurseur permet de gérer le type de curseur utilisé lors d'une connexion (Connecteurs Natifs, OLE DB, ...). Il est possible de :
  • Connaître le type de curseur utilisé pour une connexion (Connecteurs Natifs, OLE DB, ...).
  • Définir le type de curseur utilisé pour la connexion (Connecteurs Natifs, OLE DB, ...). Dans ce cas, si la connexion est actuellement ouverte, elle sera fermée, puis ré-ouverte avec les nouveaux paramètres lors d'un premier accès à un fichier utilisant cette connexion.
Remarques :
  • La connexion peut correspondre :
  • En HFSQL Client/Serveur, les curseurs ne sont pas pris en compte.
Exemple
MaConnexion est une Connexion
// Description de la connexion
MaConnexion.Utilisateur = "USER"
MaConnexion.MotDePasse = "PASSWORD"
MaConnexion.Serveur = "MONSERVEUR"
MaConnexion.BaseDeDonnées = "Base de données"
MaConnexion.Provider = hAccèsHFClientServeur
MaConnexion.Accès = hOLectureEcriture
MaConnexion.InfosEtendues = "Infos étendues"
MaConnexion.OptionsCurseur = hCurseurServeur
 
HOuvreConnexion(MaConnexion)
Syntaxe

Connaître le type de curseur Masquer les détails

<Type de curseur> = <Connexion manipulée>.OptionsCurseur
<Type de curseur> : Constante de type Entier
Renvoie le type de curseur utilisé. Ce paramètre peut correspondre à une ou plusieurs des constantes suivantes :
Emplacement des curseurs
hCurseurClientCurseur géré par le MDAC. Offre souvent plus de fonctionnalités qu'un curseur serveur. Un curseur client est obligatoirement un curseur statique.
hCurseurServeurCurseur géré par la base de données. Ce curseur peut répercuter facilement les changements effectués par d'autres utilisateurs sur les données.
Type de curseur
hCurseurDynamiqueCurseur offrant de nombreuses fonctionnalités, mais consommant beaucoup de mémoire. Ce curseur autorise tous les types de déplacement. Il permet d'accéder à toutes les modifications, ajouts et suppressions réalisées par les autres utilisateurs.
hCurseurForwardOnlyCurseur rapide et consommant peu de mémoire. Le déplacement se fait du premier enregistrement au dernier. Les données modifiées par les autres utilisateurs ne sont pas visibles.
hCurseurOpenKeySetCurseur manipulant un jeu d'enregistrements figé. Seules des clés correspondant à l'enregistrement sont stockées et non les enregistrements (peu de ressources mémoire utilisées). Les enregistrements supprimés ne sont plus accessibles. Les modifications réalisées par les autres utilisateurs sont visibles (mais pas les ajouts).
hCurseurStatiqueRécupère une copie de tous les enregistrements de la requête en mémoire (consommation mémoire importante). Tous les types de déplacement sont autorisés.
Modes de blocage
hCurseurLectureSeuleLe jeu d'enregistrements manipulé ne pourra pas être modifié.
hCurseurOptimisteL'enregistrement n'est verrouillé que lors de sa mise à jour
hCurseurPessimisteL'enregistrement est verrouillé dès son édition pour être modifié.

Remarque : Si aucune constante n'a été spécifiée dans la fonction HDécritConnexion ou dans la connexion, ce paramètre vaut 0.
Attention : Tous les providers OLE DB ou les Connecteurs Natifs ne gèrent pas tous les types de curseur.
<Connexion manipulée> : Chaîne de caractères ou variable de type Connexion
Nom de la connexion manipulée. Ce nom a été défini :

Modifier le type de curseur Masquer les détails

<Connexion manipulée>.OptionsCurseur = <Type de curseur>
<Connexion manipulée> : Chaîne de caractères ou variable de type Connexion
Nom de la connexion manipulée. Ce nom a été défini :
<Type de curseur> : Constante de type Entier
Renvoie le type de curseur utilisé. Ce paramètre peut correspondre à une ou plusieurs des constantes suivantes :
Emplacement des curseurs
hCurseurClientCurseur géré par le MDAC. Offre souvent plus de fonctionnalités qu'un curseur serveur. Un curseur client est obligatoirement un curseur statique.
hCurseurServeurCurseur géré par la base de données. Ce curseur peut répercuter facilement les changements effectués par d'autres utilisateurs sur les données.
Type de curseur
hCurseurDynamiqueCurseur offrant de nombreuses fonctionnalités, mais consommant beaucoup de mémoire. Ce curseur autorise tous les types de déplacement. Il permet d'accéder à toutes les modifications, ajouts et suppressions réalisées par les autres utilisateurs.
hCurseurForwardOnlyCurseur rapide et consommant peu de mémoire. Le déplacement se fait du premier enregistrement au dernier. Les données modifiées par les autres utilisateurs ne sont pas visibles.
hCurseurOpenKeySetCurseur manipulant un jeu d'enregistrements figé. Seules des clés correspondant à l'enregistrement sont stockées et non les enregistrements (peu de ressources mémoire utilisées). Les enregistrements supprimés ne sont plus accessibles. Les modifications réalisées par les autres utilisateurs sont visibles (mais pas les ajouts).
hCurseurStatiqueRécupère une copie de tous les enregistrements de la requête en mémoire (consommation mémoire importante). Tous les types de déplacement sont autorisés.
Modes de blocage
hCurseurLectureSeuleLe jeu d'enregistrements manipulé ne pourra pas être modifié.
hCurseurOptimisteL'enregistrement n'est verrouillé que lors de sa mise à jour
hCurseurPessimisteL'enregistrement est verrouillé dès son édition pour être modifié.

Attention : Tous les providers OLE DB ou les Connecteurs Natifs ne gèrent pas tous les types de curseur.
Remarques
La propriété CxOptionsCurseur permet de connaître le type de curseur utilisé lors d'une connexion. Cette propriété est conservée par compatibilité. Il est conseillé d'utiliser la propriété OptionsCurseur.
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale