User Guide

cfdirectory 95
cfdirectory
Description
Manages interactions with directories.
Category
File management tags
Syntax
<cfdirectory
action = "directory action"
directory = "directory name"
name = "query name"
filter = "list filter"
mode = "permission"
sort = "sort specification"
newDirectory = "new directory name">
See also
cffile
History
ColdFusion MX:
• Changed behavior for action = "list":
■ On Windows, cfdirectory action = "list" no longer returns the directory entries "."
(dot) or
".." (dot dot), which represent "the current directory" and "the parent directory."
■ On Windows, cfdirectory action = "list" no longer returns the values of the Archive
and System attributes.
■ On UNIX and Linux, cfdirectory action = "list" does not return any information in
the
mode column.
Attributes
Attribute Req/Opt Default Description
action Optional List • list: returns a query record set of the files in the
specified directory. The directory entries "." (dot) and
".." (dot dot), which represent the current directory and
the parent directory, are not returned.
• create
• delete
• rename
directory Required Absolute pathname of directory against which to
perform action.
name Required if
action =
"list"
Name for output record set.
filter Optional if
action =
"list"
File extension filter applied to returned names. For
example: *.cfm. One filter can be applied.