-->ColdFusion 初级教程-->文件和目录操作

CFFPT文件和目录操作属性

属性

描述

ACTION

如果连接没有被缓冲，则需要此属性，否则不需要。

指明要执行的FTP操作，这些操作可以是下列之一：

· ChangeDir

· CreateDir

· ListDir

· GetFile

· PutFile

· Rename

· Remove

· GetCurrentDir

· GetCurrentURL

· ExistsDir

· ExistsFile

· Exists

注意：文件名和目录名是区分大小写的。例如，对test.log执行ListDir操作不会找到test.LOG。

USERNAME

用于建立FTP连接的用户名。如果连接已经被缓冲，则不需要此属性。

PASSWORD

用于建立连接的密码。如果连接已经被缓冲，则不需要此属性。

NAME

当ACTION=”ListDir”时需要此属性，用于指定用来保存目录列表的查询名。

SERVER

要与之建立连接的服务器名。如果连接已经被缓冲，则不需要此属性。

TIMEOUT

可选。用于指定所有操作的超时秒数。缺省值是30秒。

PORT

可选。用于指定远程服务器的端口号。

CONNECTION

可选。指定FTP连接的名字，用于缓冲当前的FTP连接或重用已缓冲的FTP连接。所有使用相同连接名的CFFTP都使用相同的连接信息。

ASCIIEXTENSIONLIST

可选。一列用分号隔开的文件扩展名，用于在TRANSFERMODE=”Autodetect”时强制进行ASCII传输模式。缺省的扩展名列表是：

txt;htm;html;cfm;cfml;shtm;shtml;css;asp;asa

TRANSFERMODE

可选。指定你要用的FTP传输模式。合法的输入有ASCII,Binary,或Autodetect。缺省值是Autodect.

AGENTNAME

可选。管理传输的应用程序。

FAILIFEXISTS

可选。其值为Yes或NO，缺省为Yes。用于指明当同名的文件已经存在时，GetFile操作是否失败。

DIRECTORY

当ACTION=ChangeDir,CreateDir,ListDir,ExistsDir时需要此属性。用于指定要对之进行操作的目录。

LOCALFILE

当ACTION=GetFile,PutFile时需要此属性。用于指定用户本地文件系统中的文件名。

REMOTEFILE

当ACTION=GetFile,PutFile,ExistsFile时需要此属性。用于指定FTP服务器上文件系统中的文件名。

ATTRIBUTES

可选。一列用逗号隔开的文件属性。缺省值为”Normal”。用于在GetFile操作中指定本地文件的文件属性。其值可以是下列值的任意组合：

· ReadOnly

· Hidden

· System

· Archive

· Directory

· Compressed

· Temporary

· Normal

ITEM

当ACTION=Exists,Remove时需要此属性。用于指定这些操作的对象，文件或目录。

EXISTING

当ACTION=Rename时需要此属性。指定远程服务器上文件或目录的当前名字。

NEW

当ACTION=Rename时需要此属性。指定远程服务器上文件或目录的新名字。

RETRYCOUNT

可选。报错之前的重试次数。缺省值是1。

STOPONERROR

可选。其值为Yes或No，缺省值为NO。当为Yes时，停止所有的处理并显示合适的错误信息；当为No时，产生三个变量：

· CFFTP.Succeeded---Yes 或NO.

· CFFTP.ErrorCode---错误号。

· CFFTP.ErrorText---解释错误情况的错误信息。