4D v16.3
DELETE FOLDER
- 4D Programmiersprache
-
- Systemdokumente
-
- Einführung in Systemdokumente
- Append document
- CLOSE DOCUMENT
- Convert path POSIX to system
- Convert path system to POSIX
- COPY DOCUMENT
- CREATE ALIAS
- Create document
- CREATE FOLDER
- DELETE DOCUMENT
- DELETE FOLDER
- Document creator
- DOCUMENT LIST
- Document to text
- Document type
- FOLDER LIST
- GET DOCUMENT ICON
- Get document position
- GET DOCUMENT PROPERTIES
- Get document size
- Get localized document path
- MAP FILE TYPES
- MOVE DOCUMENT
- Open document
- RESOLVE ALIAS
- Select document
- Select folder
- SET DOCUMENT CREATOR
- SET DOCUMENT POSITION
- SET DOCUMENT PROPERTIES
- SET DOCUMENT SIZE
- SET DOCUMENT TYPE
- SHOW ON DISK
- Test path name
- TEXT TO DOCUMENT
- VOLUME ATTRIBUTES
- VOLUME LIST
DELETE FOLDER
| DELETE FOLDER ( Ordner {; LöschOption} ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| Ordner | String |
|
Name oder ganzer Pfad des Ordners zum Löschen | |||||
| LöschOption | Lange Ganzzahl |
|
Option Ordner Löschen | |||||
Der Befehl DELETE FOLDER löscht den Ordner, dessen Name bzw. voller Pfad in Ordner übergeben wurde.
Aus Sicherheitsgründen lässt DELETE FOLDER standardmäßig nur das Löschen leerer Ordner zu. Damit der Befehl auch nicht-leere Ordner löschen kann, müssen Sie den Parameter LöschOption übergeben. Sie können eine der folgenden Konstanten unter dem Thema "Systemdokumente" übergeben:
| Konstante | Typ | Wert | Kommentar |
| Delete only if empty | Lange Ganzzahl | 0 | Löscht den Ordner nur, wenn er leer ist |
| Delete with contents | Lange Ganzzahl | 1 | Löscht den Ordner mitsamt seinem Inhalt |
- Ist Delete only if empty (0) übergeben oder der Parameter LöschOption wird weggelassen:
- Der im Parameter Ordner angegebene Ordner wird nur gelöscht, wenn er leer ist; andernfalls führt der Befehl nichts aus und es wird ein Fehler -47 generiert (Die Datei ist schon offen oder der Ordner ist nicht leer.)
- Existiert der angegebene Ordner nicht, wird der Fehler -120 generiert (Dateizugriff über Pfadname zu einem nicht existierenden Ordner)
- Ist Delete with contents (1) übergeben:
- Der im Parameter Ordner angegebene Ordner wird mit dem gesamten Inhalt gelöscht.
Warnung: Selbst wenn dieser Ordner bzw. sein Inhalt gesperrt oder auf Nur-Lesen gesetzt sind, und der aktuelle Benutzer passende Zugriffsrechte hat, werden Ordner und Inhalt trotzdem gelöscht. - Kann dieser Ordner oder eine darin enthaltene Datei nicht gelöscht werden, wird der Löschvorgang beim ersten nicht löschbaren Element abgebrochen und ein Fehler (*) zurückgegeben. Der Ordnerinhalt kann also teilweise gelöscht sein. Bei Abbruch können Sie über den Befehl GET LAST ERROR STACK Name und Pfad der dafür verantwortlichen Datei ermitteln.
- Existiert der im Parameter Ordner angegebene Ordner nicht, führt der Befehl nichts aus und es wird kein Fehler zurückgegeben.
(*) unter Windows: -54 (Es wurde versucht, ein gesperrtes Volume im Schreibmodus zu öffnen)
auf OS X: -45 (Datei ist gesperrt oder der Pfadname ist nicht korrekt)
- Der im Parameter Ordner angegebene Ordner wird mit dem gesamten Inhalt gelöscht.
Sie können diese Fehler mit einer Methode abfangen, die der Befehl ON ERR CALL einrichtet.
Produkt: 4D
Thema: Systemdokumente
Nummer:
693
Erstellt: 4D v6.7
Geändert: 4D v15 R5
4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)
