DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL
  • Présentation
  • Modifier le contenu d'une requête exécutée AVEC la constante hAvecFiltre
  • Modifier le contenu d'une requête exécutée SANS la constante hAvecFiltre
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
Modifier le contenu d'une requête
ODBCNon disponible avec ce type de connexion
Présentation
Les requêtes constituent un moyen simple et rapide pour sélectionner des enregistrements provenant d'un ou plusieurs fichiers de données, répondant à un ou plusieurs critères de sélection, ...
Que votre requête soit réalisée à l'aide de l'éditeur de requêtes ou par programmation, les enregistrements sélectionnés par la requête peuvent être modifiés directement lors du parcours du résultat de la requête.
Cette modification peut être effectuée :
  • soit uniquement dans le résultat de la requête (fichier de données HFSQL).
  • soit dans le résultat de la requête et dans les fichiers de base de la requête :
    • Fichiers manipulés par OLE DB ou par un Accès Natif : cette modification est réalisée automatiquement.
    • Fichiers HFSQL :
      • Requête exécutée avec la constante hAvecFiltre : la modification du fichier est automatiquement réalisée.
      • Requête exécutée sans la constante hAvecFiltre : Il est nécessaire d'utiliser la constante hModifieFichier lors de l'exécution de la requête avec les fonctions HExécuteRequête et HExécuteRequêteSQL.
Le report des modifications effectuées dans la requête sur le fichier de base n'est effectué que pour les rubriques modifiées dans la requête.
Modifier le contenu d'une requête exécutée AVEC la constante hAvecFiltre
Plusieurs fonctions permettent de modifier le résultat de la requête. Dans tous les cas, la modification est directement réalisée sur le fichier de données de base de la requête.
FonctionFonctionnalitéLimites/Possibilités
HAjouteAjoute l'enregistrement présent en mémoire dans le fichier de données.
  • Utilisable uniquement sur les requêtes mono-fichier.
  • Les rubriques calculées précisées lors de l'ajout sont ignorées. Elles sont automatiquement calculées.
HEcritÉcrit un enregistrement dans le fichier de données sans mettre à jour les index correspondants à toutes les clés utilisées dans le fichier.
  • La fonction HEcrit peut être utilisée.
HModifieModifie l'enregistrement spécifié ou l'enregistrement présent en mémoire dans le fichier de données.
  • Seule la modification de l'enregistrement courant est possible.
  • Si la fonction est exécutée pour modifier une requête basée sur plusieurs fichiers, la modification est répercutée sur les fichiers liés.
  • La modification du contenu d'une rubrique calculée provoque une erreur WLangage. Le contenu de ces rubriques est automatiquement calculé lors de la modification de l'enregistrement.
HRayeRaye un enregistrement d'un fichier. L'enregistrement est supprimé logiquement et pourra éventuellement récupéré.
  • Utilisable uniquement sur les requêtes mono-fichier.
HSupprimeSupprime un enregistrement d'un fichier. L'enregistrement est supprimé logiquement et physiquement. Il ne pourra pas être restauré (contrairement aux enregistrements rayés avec la fonction HRaye).
  • Utilisable uniquement sur les requêtes mono-fichier.
Attention :
  • Toute modification d'une requête utilisant les groupes ou les agrégats est interdite.
  • La gestion de l'intégrité et des doublons n'est pas réalisée lors d'opérations sur les requêtes multi-fichiers : il est conseillé d'utiliser les transactions pour éviter tout problème.
Modifier le contenu d'une requête exécutée SANS la constante hAvecFiltre
Plusieurs fonctions permettent de modifier le résultat de la requête. Il est possible de modifier soit le résultat de la requête, soit les fichiers de données intervenant dans la requête (constante hModifieFichier précisée dans les fonctions HExécuteRequête et HExécuteRequêteSQL).
FonctionFonctionnalitéLimites/Possibilités
HAjouteAjoute l'enregistrement présent en mémoire dans le fichier de données.
  • Utilisable uniquement sur les requêtes mono-fichier.
  • Les rubriques calculées précisées lors de l'ajout sont ignorées. Elles sont automatiquement calculées.
HEcritÉcrit un enregistrement dans le fichier de données sans mettre à jour les index correspondants à toutes les clés utilisées dans le fichier.
  • Inutilisable.
HModifieModifie l'enregistrement spécifié ou l'enregistrement présent en mémoire dans le fichier de données.
  • Si la fonction est exécutée pour modifier une requête basée sur plusieurs fichiers, la modification est répercutée sur les fichiers liés.
  • Si l'enregistrement modifié ne correspond plus à la sélection de la requête, l'enregistrement sera toujours présent dans le résultat de la requête
  • La modification du contenu d'une rubrique calculée provoque une erreur WLangage. Le contenu de ces rubriques est automatiquement calculé lors de la modification de l'enregistrement.
HRayeRaye un enregistrement d'un fichier. L'enregistrement est supprimé logiquement et pourra éventuellement récupéré.
  • Utilisable uniquement sur les requêtes mono-fichier.
HSupprimeSupprime un enregistrement d'un fichier. L'enregistrement est supprimé logiquement et physiquement. Il ne pourra pas être restauré (contrairement aux enregistrements rayés avec la fonction HRaye).
  • Utilisable uniquement sur les requêtes mono-fichier.
Attention :
  • Toute modification d'une requête utilisant les groupes ou les agrégats est interdite.
  • La gestion de l'intégrité et des doublons n'est pas réalisée lors d'opérations sur les requêtes multi-fichiers : il est conseillé d'utiliser les transactions pour éviter tout problème.
  • Sur des fichiers non HFSQL, la constante hModifieFichier est inutile : lors de la modification du résultat de la requête, les fichiers intervenant dans la requête sont automatiquement modifiés.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

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