MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 97 / 806

cfdirectory 97
Note: If the
cfdirectory
tag does not appear to work, for example, if a
list
operation returns an
empty result set, make sure that you have correct permissions to access the directory. For example, if
you run ColdFusion as a service on Windows, it operates by default as System, and cannot access
directories on a remote system or mapped drive; to resolve this issue, do not run ColdFusion using
the local system account.
The
filter
attribute specifies a pattern of one or more characters. All names that match that
pattern are included in the list. On Windows systems, pattern matching ignores text case, on
UNIX and Linux, pattern matches are case-sensitive.
The following 2 characters have special meaning in the pattern and are called metacharacters:
•
* matches any zero or more characters
•
? matches any single character
The following table shows examples of patterns and file names that they match:
Example
<h3>cfdirectory Example</h3>
<!--- use cfdirectory to give the contents of the directory that contains
this page order by name and size --->
<cfdirectory
directory="#GetDirectoryFromPath(GetTemplatePath())#"
name="myDirectory"
sort="name ASC, size DESC">
<!---- Output the contents of the cfdirectory as a cftable ----->
<cftable
query="myDirectory"
htmltable
colheaders>
<cfcol
header="NAME:"
text="#Name#">
<cfcol
header="SIZE:"
text="#Size#">
</cftable>
Pattern Matches
foo.* any file called foo with any extention i.e. foo.html, foo.cfm, foo.xml, ...
*.html all files with the suffix .html, but not files with the suffix .htm.
?? all files with 2 character names.