Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Edge HMI

DirDelete

  • Last UpdatedOct 29, 2026
  • 2 minute read

Deletes the specified directory.

Function

Group

Execution

String Exp.

Windows

Windows Embedded

IoT View

Thin Clients

Mobile Access

DirDelete

File

Synchronous

No

Supported

Supported

Supported

Executed on Server (see Notes below)

Supported

Syntax

DirDelete( strDirectory, optBooEmptyOnly )

strDirectory

The name and file path of the directory to delete.

Tip: This parameter supports wildcards ( * and ? ).

Note: Follow the conventions of the target platform for the file path and name, and separators. For example, a file path in Windows starts with a drive letter and uses backward slashes as separators (C:\path\to\file), while a file path in Linux starts at the root directory and uses forward slashes as separators (/path/to/file).

optBooEmptyOnly

Optional flag. If this parameter has a value of 1, then the directory is deleted only if it is empty. By default โ€” that is, if the parameter is omitted or has a value of 0 โ€” the directory is deleted whether it is empty or not.

Returned value

Value

Description

-2

Attempted to delete a non-empty directory when this action is not allowed (that is, optBooEmptyOnly does not equal 0).

-1

Invalid parameters.

0

Failed to delete the directory (that is, directory does not exist).

1

Directory deleted successfully.

Notes

By default, this function is executed on the project runtime server even when it is called in a screen on a project thin client, which means it only affects directories and files that are located on the server and all paths must be specified in that context. You can change the default behavior to force this function to be executed on the client where it is called, but if you do so, you must keep in mind that the change will affect not just this function but also several other File functions. To change the behavior of these functions, use a text editor to open your project file (<project name>.app) and then edit the following property:

[Options]

ExecuteFileFunctionsOnClient=1

Examples

Tag Name

Expression

Tag

DirDelete( "C:\Studio\Temp" ) // The Temp folder from C:\Studio is deleted.

Tag

DirDelete( "C:\Studio\Temp", 1 ) // The Temp folder from C:\Studio is deleted only if it is empty.

In This Topic
Related Links