PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


Nouveauté WINDEV, WEBDEV, WINDEV Mobile 25 !
  • Manipulations d'un enregistrement rayé
  • Nombre d'enregistrements rayés
  • Version du fichier de données
  • Rayer un enregistrement à partir d'une requête
  • Cas particuliers
  • Fichiers xBase
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Raye un enregistrement d'un fichier de données. L'enregistrement est supprimé logiquement et pourra éventuellement être récupéré.
Les opérations effectuées sont les suivantes :
  • l'enregistrement est rendu inactif. Les données sont conservées (ce qui n'est pas le cas lors de la suppression d'un enregistrement avec la fonction <Source>.Supprime).
  • les index (correspondant aux clés de l'enregistrement) sont supprimés du fichier d'index.
  • les mémos associés à l'enregistrement sont conservés.
Cette fonction peut être utilisée indifféremment avec les fichiers de données, les vues HFSQL Mobile ou les requêtes.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
WINDEVJava Cette fonction est désormais disponible pour les applications Java (pour les fichiers de données HFSQL).
Widget Android Cette fonction est désormais disponible en mode Widget Android (pour les fichiers de données HFSQL).
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
WINDEVJava Cette fonction est désormais disponible pour les applications Java (pour les fichiers de données HFSQL).
Widget Android Cette fonction est désormais disponible en mode Widget Android (pour les fichiers de données HFSQL).
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
WINDEVJava Cette fonction est désormais disponible pour les applications Java (pour les fichiers de données HFSQL).
Widget Android Cette fonction est désormais disponible en mode Widget Android (pour les fichiers de données HFSQL).
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Raye l'enregistrement numéro 123
Client.Raye(123)
// Suppression (rayure) des commandes d'un client
Commande.LitRecherchePremier(NUMCLI, ValNumCli)
TANTQUE Commande.Trouve() = Vrai
Commande.Raye()
Commande.LitSuivant()
FIN
Syntaxe
<Résultat> = <Source>.Raye([<Numéro d'enregistrement> [, <Options>]])
<Résultat> : Booléen
  • Vrai si l'enregistrement a été rayé,
  • Faux en cas d'erreur (enregistrement bloqué, problème d'intégrité, ...). La fonction HErreurInfo permet d'obtenir plus de détails.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données HFSQL, de la requête ou de la vue manipulé.
<Numéro d'enregistrement> : Entier optionnel
Numéro de l'enregistrement à rayer.
Si ce paramètre n'est pas précisé (est égal à 0 ou à la constante hNumEnrEnCours), l'enregistrement en cours sera rayé.
<Options> : Constante optionnelle
Paramètre :
  • le blocage de l'enregistrement rayé. Si aucune constante de blocage n'est spécifiée, l'enregistrement rayé n'est pas bloqué.
    hBlocageNon
    (valeur par défaut)
    Aucun blocage : l'enregistrement rayé ne sera pas bloqué.
    hBlocageEcritureBlocage en écriture : l'enregistrement rayé en cours pourra être lu et consulté (fonction <Source>.Lit) par une autre application mais ne pourra pas être ré-activé par une autre application. Seule l'application en cours pourra le ré-activer.
    hBlocageLectureEcritureBlocage en lecture/écriture : l'enregistrement rayé en cours ne pourra ni être consulté ni être ré-activé par une autre application.

    Windows Mobile La gestion des blocages est réalisée uniquement sur les fichiers de données HFSQL Client/Serveur ou manipulés par un Connecteur Natif. Il n'est pas possible de bloquer un enregistrement HFSQL Mobile. En effet, le système d'exploitation du Pocket PC ne permet pas de bloquer des enregistrements.
  • la gestion de l'intégrité sur l'enregistrement rayé.
    hIgnoreIntégritéIgnore le contrôle d'intégrité sur cette opération, même si le contrôle de l'intégrité automatique est branché (fonction HGèreIntégrité).
    hVérifieIntégritéContrôle l'intégrité de l'opération, même si le contrôle de l'intégrité automatique est débranché (fonction HGèreIntégrité).

    Si les deux constantes sont utilisées en même temps, une erreur WLangage est générée. Ces constantes n'ont pas d'effet sur la suppression en cascade.
Remarques

Manipulations d'un enregistrement rayé

Nombre d'enregistrements rayés

La fonction <Source>.NbEnr permet de connaître le nombre d'enregistrements rayés dans le fichier de données.
Remarque : Par compatibilité avec WEBDEV 1.5/WINDEV 5.5, il est aussi possible de connaître le nombre d'enregistrements rayés grâce à la variable h.NbSup.

Version du fichier de données

En cas de succès de la fonction <Source>.Raye, le numéro de version du fichier de données est modifié. Ce numéro de version est donné par la fonction <Source>.Version.

Rayer un enregistrement à partir d'une requête

Il est possible de rayer un enregistrement :
Quel que soit le mode d'exécution de la requête (avec ou sans la constante hAvecFiltre), la fonction <Source>.Raye n'est utilisable que sur les requêtes mono-fichier.
Attention :
  • Il est impossible de rayer un enregistrement dans une requête utilisant les groupes ou les agrégats.
  • 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.

Cas particuliers

  • Gestion des blocages :
    Si un problème de blocage apparaît lors de la "rayure" d'un enregistrement (tentative de rayure d'un enregistrement bloqué en écriture par exemple), l'enregistrement n'est pas modifié et la fonction HErreurBlocage renvoie Vrai.
    Windows Mobile Aucune gestion des blocages n'est réalisée. En effet, le système d'exploitation du Pocket PC ne permet pas de bloquer des enregistrements.
  • Gestion de l'intégrité référentielle
    Si la gestion de l'intégrité référentielle est active (fonction HGèreIntégrité), et si l'intégrité n'est pas vérifiée lors de la suppression, la fonction <Source>.Raye n'est pas exécutée. Il est nécessaire de tester la fonction HErreurIntégrité après la fonction <Source>.Raye.
  • Enregistrements supprimés
    La fonction <Source>.Raye ne doit pas être appelée sur un enregistrement précédemment supprimé.
WINDEVWEBDEV - Code ServeurConnecteurs Natifs (Accès Natifs)

Fichiers xBase

La fonction <Source>.Supprime a le même effet que la fonction <Source>.Raye : l'enregistrement est rayé et non supprimé. L'enregistrement peut donc être réactivé par la fonction <Source>.Modifie. Dans ce cas, la fonction <Source>.Etat renvoie la constante hEtatRaye sur un enregistrement supprimé (et non la constante hEtatSup).
Composante : wd250hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire