PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
OptionsCurseur (Propriété)
En anglais : CursorOptions
OLE DBAccès NatifsDisponible uniquement avec ces types de connexion
La propriété ..OptionsCurseur permet de gérer le type de curseur utilisé lors d'une connexion (Accès Natifs, OLE DB, ...). Il est possible de :
  • Connaître le type de curseur utilisé pour une connexion (Accès Natifs, OLE DB, ...).
  • Définir le type de curseur utilisé pour la connexion (Accès 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.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
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> = <Nom de la connexion>..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 accès natifs ne gèrent pas tous les types de curseur.
<Nom de la connexion> : Chaîne de caractères (avec ou sans guillemets)
Nom de la connexion manipulée. Ce nom a été défini :

Modifier le type de curseur Masquer les détails

<Nom de la connexion>..OptionsCurseur = <Type de curseur>
<Nom de la connexion> : Chaîne de caractères (avec ou sans guillemets)
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 accès 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.
Voir Aussi
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire