4D v16.3

DELETE FOLDER

Accueil

 
4D v16.3
DELETE FOLDER

DELETE FOLDER 


 

DELETE FOLDER ( dossier {; optionSuppression} ) 
Paramètre Type   Description
dossier  Chaîne in Nom ou chemin d’accès complet du dossier à supprimer
optionSuppression  Entier long in Option de suppression du dossier

La commande DELETE FOLDER supprime le dossier dont vous avez passé le nom ou le chemin d’accès complet dans dossier.

Par défaut pour des raisons de sécurité, si vous omettez le paramètre optionSuppression, DELETE FOLDER permet uniquement la suppression de dossiers vides. Si vous souhaitez que cette commande puisse supprimer des dossiers non vides, vous devez utiliser le paramètre optionSuppression. Vous pouvez passer dans ce paramètre l'une des constantes suivantes, placées dans le thème "Documents système" :

Constante Type Valeur Comment
Delete only if empty Entier long 0 Supprime le dossier uniquement s'il est vide
Delete with contents Entier long 1 Supprime le dossier ainsi que son éventuel contenu
  • Si vous passez Delete only if empty ou omettez le paramètre optionSuppression :
    • Le dossier désigné par le paramètre dossier n'est supprimé que s'il est vide ; sinon, la commande ne fait rien et une erreur -47 (Fichier déjà ouvert, ou dossier non vide) est générée.
    • Si le dossier désigné n'existe pas, l'erreur -120 (Tentative d'accès à un fichier avec un chemin d'accès spécifiant un répertoire inexistant) est générée.
  • Si vous passez Delete with contents :
    • Le dossier ainsi que tout son contenu sont supprimés.
      Attention :
      Si le dossier est verrouillé ou en lecture seule, il sera néanmoins supprimé si l'utilisateur courant dispose des droits d’accès nécessaires.
    • Si le dossier désigné ou un des fichiers qu'il contient ne peut pas être supprimé, la procédure de suppression est abandonnée dès que le premier élément inaccessible est atteint, et une erreur(*) est retournée. Dans ce cas, le dossier ne sera que partiellement supprimé. Il est cependant possible d'utiliser la commande GET LAST ERROR STACK pour obtenir le nom et le chemin d’accès du fichier à l'origine de l'erreur.
    • Si le dossier désigné n'existe pas, la commande ne fait rien et aucune erreur n'est générée.

      (*) sous Windows : -54 (Tentative d'écriture dans un fichier verrouillé)
      sous OS X : -45 (Fichier verrouillé ou chemin d'accès invalide)

Vous pouvez intercepter ces erreurs à l’aide d’une méthode installée par la commande ON ERR CALL .



Voir aussi  


DELETE DOCUMENT

 
PROPRIÉTÉS 

Produit : 4D
Thème : Documents système
Numéro : 693

Cette commande modifie la variable système OKCette commande modifie la variable système ErrorCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D v6.7
Modifié : 4D v15 R5

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)