User Guide

Chapter 1: ColdFusion Tags 33
CFDIRECTORY
Use the CFDIRECTORY tag to handle all interactions with directories.
Note 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.
Syntax <CFDIRECTORY ACTION="directory action"
DIRECTORY="directory name"
NAME="query name"
FILTER="list filter"
MODE="permission"
SORT="sort specification"
NEWDIRECTORY="new directory name">
ACTION
Optional. Defines the action to be taken with directory(ies) specified in
DIRECTORY. Valid entries are:
• List (default)
• Create
• Delete
• Rename.
DIRECTORY
Required for all ACTIONs. The name of the directory you want the action to be
performed against.
NAME
Required for ACTION="List". Ignored for all other actions. Name of output query
for directory listing.
FILTER
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.
MODE