|
CFDIRECTORY标签用于返回指定目录的文件信息，并可以对目录进行创建，删除和重命名等操作。
与CFFILE一样，在ColdFusion Administrator中可以禁止CFDIRECTORY标签。CFDIRECTORY的各属性如下表所列：
|
CFDIRECTORY 属性 |
|
属性 |
描述 |
|
ACTION |
可选。定义要对DIRECTORY属性中指定的目录所执行的操作。合法的输入包括：
· List
· Create
· Delete
· Rename
缺省值为List. |
|
DIRECTORY |
要对之执行目录操作的目录名。 |
|
NAME |
目录列表输出的查询名。ACTION= ”List”时要指定此属性，其他操作忽略此属性。 |
|
FILTER |
用于过滤返回的文件名，如 ”*.cfm”。ACTION=”List”时可指定此属性，其他操作忽略此属性。 |
|
MODE |
可选。只在Solaris中，在ACTION= ”Create”时使用，用于设置一个目录的许可权限。在Windows中将被忽略。
其合法取值对应于UNIX的chmod命令的十进制值。许可权限按照“所有者，组，其它”的顺序分别设置。例如：
MODE=644
赋予所有者读/写权限，组和其它用户被赋予读权限。 |
|
SORT |
ACTION= ”List”时可选，对其它操作被忽略。可用此属性指定一列字段名，相互间用逗号隔开，根据这些字段对输出的目录列表进行排序。对每个字段可指定ASC或DESC，按升序或降序排序。例如：
SORT= ”colname
ASC,filename2 DESC,size,datelastmodified” |
|
NEWDIRECTORY |
DIRECTORY属性中指定的目录的新目录名。ACTION= ”Rename”时要指定此属性，其它操作忽略该属性。 |
返回文件信息（ACTION=“LIST”）
当ACTION=“LIST”时，CFDIRECTORY返回五个变量，你可以在CFOUTPUT中引用这些变量：
· Name——目录名或文件名。
· Size——目录大小或文件大小。
· Type——文件类型：F代表文件，D代表目录。
· DateLastModified——最后一次被修改的时间。
· Attributes——文件属性。
·
Mode——（仅Solaris支持）代表指定目录的权限设置的十进制数。
例子
你可以在CFML扩展中使用查询结果字段，只需以查询名作为字段名的前缀。
<CFDIRECTORY
DIRECTORY="c:\winnt\system32"
NAME="mydirectory"
SORT="size ASC, name DESC, datelastmodified">
<CFOUTPUT QUERY=”mydirectory”>
Name: #mydirectory.name# <BR>
Size: #mydirectory.size# <BR>Type: #mydirectory.type# <BR>
Date last modified: #mydirectory.datelastmodified# <BR>
Attributes: #mydirectory.attributes#<BR>
Mode: #mydirectory.mode#<BR>
</CFOUTPUT>
|
