Macromedia coldfusion 4.5-cfml language reference User Manual

Chapter 1:  ColdFusion Tags

33

CFDIRECTORY

Use the CFDIRECTORY tag to handle all interactions with directories. 

The ColdFusion Server Basic security settings may prevent 
CFDIRECTORY from executing. These settings are managed using the 
ColdFusion Administrator Basic Security page. In order for 
CFDIRECTORY to execute, it needs to be enabled on the Basic Security 
page. 

If you write ColdFusion applications designed to run on a server that is used by 
multiple customers, you need to consider the security of the files and directories that 
could be uploaded or otherwise manipulated by CFDIRECTORY. Please refer to 
Administering ColdFusion Server for more information about securing ColdFusion 
tags.

<CFDIRECTORY ACTION="directory action"

DIRECTORY="directory name"
NAME="query name"
FILTER="list filter"
MODE="permission"
SORT="sort specification"
NEWDIRECTORY="new directory name">

Optional. Defines the action to be taken with directory(ies) specified in 
DIRECTORY. Valid entries are: 

•

List (default)

•

Create

•

Delete

•

Rename. 

Required for all ACTIONs. The name of the directory you want the action to be 
performed against.

Required for ACTION="List". Ignored for all other actions. Name of output query 
for directory listing.

Optional for ACTION="List". Ignored for all other actions. File extension filter to 
be applied to returned names, for example: 

*.cfm

. Only one mask filter can be 

applied at a time.