Use the cfdirectory
tag to return file information from a specified directory and to create, delete, and rename directories.
As with cffile
, you can disable cfdirectory
processing in the ColdFusion Administrator. For details on the syntax of this tag, see CFML Reference.
When you use the action="list"
attribute setting, cfdirectory
returns a query object as specified in the name
attribute. The name
attribute is required when you use the action="list"
attribute setting. This query object contains five result columns that you can reference in a cfoutput
tag, using the name
attribute:
name
Directory entry name.
size
Directory entry size.type
File type: File or Dir.dateLastModified
Date an entry was last modified.attributes
(Windows only) File attributes, if applicable.mode
(UNIX only) The octal value representing the permissions setting for the specified directory.Note: ColdFusion supports the ReadOnly and Hidden values for the attributes
attribute for cfdirectory
sorting.
Depending on whether your server is on a UNIX system or a Windows system, either the Attributes column or the Mode column is empty. Also, you can specify a filename in the filter
attribute to get information on a single file.
The following procedure describes how to create a ColdFusion page in which to view directory information.
<html> <head> <title>List Directory Information</title> </head> <body> <h3>List Directory Information</h3> <cfdirectory directory="c:\inetpub\wwwroot\mine" name="mydirectory" sort="size ASC, name DESC, datelastmodified"> <table cellspacing=1 cellpadding=10> <tr> <th>Name</th> <th>Size</th> <th>Type</th> <th>Modified</th> <th>Attributes</th> <th>Mode</th> </tr> <cfoutput query="mydirectory"> <tr> <td>#mydirectory.name#</td> <td>#mydirectory.size#</td> <td>#mydirectory.type#</td> <td>#mydirectory.dateLastModified#</td> <td>#mydirectory.attributes#</td> <td>#mydirectory.mode#</td> </tr> </cfoutput> </table> </body> </html>