User Guide

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">

<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.