Funktionreferenz


DirRemove

Beschreibung anzeigen in

Löscht ein Verzeichnis oder einen Ordner.

DirRemove ( "path" [, recurse = 0] )

Parameter

path Pfad des Verzeichnisses, das gelöscht werden soll.
recurse [optional] Verwende dieses Flag, um auch alle Unterverzeichnisse zu entfernen.
    $DIR_DEFAULT (0) = (Standard) Löscht das Verzeichnis nur, wenn es leer ist
    $DIR_REMOVE (1) = Löscht Dateien und Unterverzeichnisse (wie beim DOS-Befehl "DelTree")

Die Konstanten sind in "AutoItConstants.au3" definiert.

Rückgabewert

Erfolg: 1
Fehler: 0, wenn ein Fehler beim Löschen auftrat oder das Verzeichnis nicht existiert.

Bemerkungen

Manche Ordnerattribute können das Löschen unmöglich machen, in diesem Fall sollte man die Funktion FileSetAttrib() verwenden, um die Ordnerattribute zu ändern.

Verwandte Funktionen

DirCopy, DirCreate, DirMove, FileDelete, FileRecycle

Beispiel

#include <AutoItConstants.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Erstellt eine Konstante im lokalen Bereich des Verzeichnisses.
    Local Const $sFilePath = @TempDir & "\DirRemoveFolder"

    ; Falls das Verzeichnis bereits existiert, beenden.
    If FileExists($sFilePath) Then
        MsgBox($MB_SYSTEMMODAL, "", "Es ist ein Fehler aufgetreten. Das Verzeichnis existiert bereits.")
        Return False
    EndIf

    ; Öffnet das temporäre Verzeichnis.
    ShellExecute(@TempDir)

    ; Erstellt das Verzeichnis.
    DirCreate($sFilePath)

    ; Zeigt eine Nachricht der Erstellung des Verzeichnisses.
    MsgBox($MB_SYSTEMMODAL, "", "Das Verzeichnis wurde erstellt.")

    ; Löscht das Verzeichnis. und alle Unterverzeichnis.
    DirRemove($sFilePath, $DIR_REMOVE)

    ; Zeigt eine Nachricht mit dem Entfernen des Verzeichnisses.
    MsgBox($MB_SYSTEMMODAL, "", "Das Unterverzeichnis: Folder2 wurde gelöscht.")
EndFunc   ;==>Example