DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL Client/Serveur
  • Suppression d'un fichier de données
  • Noms de fichiers et de répertoires sur le serveur LINUX
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
<Variable Connexion>.SupprimeFichier (Fonction)
En anglais : <Connection variable>.DeleteFile
HFSQL Client/ServeurDisponible uniquement avec ce type de connexion
Supprime les fichiers de données HFSQL (fichiers .fic, .ndx, .ftx, .sdx et .mmo s'ils existent) sur le serveur.
Exemple
MaConnexion est une Connexion
 
// Supprime des fichiers de données du serveur
MaConnexion.SupprimeFichier(".\sauvegarde\fichierclient_sov.fic")
HFSQL Client/Serveur
Cx_test est une Connexion
 
SI Cx_test.SupprimeFichier(".\Client.FIC") = Faux ALORS
Erreur(HErreurInfo())
FIN
Syntaxe
<Résultat> = <Connexion>.SupprimeFichier(<Chemin du fichier de données> [, <Options>])
<Résultat> : Booléen
  • Vrai si le fichier de données a été supprimé,
  • Faux en cas d'erreur (par exemple si le fichier de données n'existe pas sur le serveur). La fonction HErreur permet d'identifier l'erreur.
<Connexion> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion dans laquelle le fichier de données doit être supprimé.
<Chemin du fichier de données> : Chaîne de caractères
Nom et chemin physique du fichier de données à supprimer. Le chemin est relatif à la base de données : le nom de la base de données ne doit pas être précisé dans le chemin. Il est nécessaire de préciser l'extension ".fic" du fichier de données.
<Options> : Constante ou combinaison de constantes de type entier optionnel
Par défaut, lors de la suppression d'un fichier de données :
  • les fichiers correspondant aux journaux ne sont pas supprimés,
  • les fichiers correspondant aux transactions sont supprimés.
Ce paramètre permet de modifier ce comportement :
hConserveTRSConserve le fichier de transaction associé au fichier de données supprimé.
hDétruitLiaisonSupprime toutes les liaisons concernant le fichier de données supprimé.
hSupprimeJournalSupprime le fichier Journal et toutes les opérations journalées associés au fichier de données supprimé.
Remarques

Suppression d'un fichier de données

Le fichier de données peut être supprimé uniquement si il n'est pas en cours d'utilisation (c'est-à-dire s'il n'est pas utilisé par une requête, une vue, une autre fenêtre, un thread ou un composant à contexte HFSQL indépendant).
Le fichier de données est automatiquement fermé dans le contexte HFSQL qui appelle la fonction <Variable Connexion>.SupprimeFichier. Si le fichier de données est utilisé dans un contexte ou par une application, une erreur WLangage est affichée.

Noms de fichiers et de répertoires sur le serveur LINUX

Sur un serveur LINUX, le nom des fichiers de données (fichiers .fic, .ftx, .sdx, .ndx et .mmo s'ils existent) doit être en minuscules et ne pas comporter d'accents.
Composante : wd290hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/02/2024

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