CFML Reference
|
|
ColdFusion Tags
|
cffile action = "move"
Description
Moves a file from one location to another on the server.
Syntax
<cffile
action = "move"
source = "full_path_name"
destination = "full_path_name"
mode = "mode"
attributes = "file_attributes_list"
charset = "charset_option">
See also
cfdirectory
History
New in ColdFusion MX: this action
attribute option supports the charset
attribute.
New in ColdFusion MX: A directory path that you specify in the destination
attribute does not require a trailing slash.
New in ColdFusion MX: on Windows platforms, the temporary
, archive
, and system
options of the attributes
attribute are deprecated. Do not use them in new applications. They might not work, and might cause an error, in later releases.
Attributes
Attribute |
Req/Opt |
Default |
Description |
action
|
Required
|
|
Type of file manipulation that the tag performs.
|
source
|
Required
|
|
Absolute pathname of file on web server. On Windows, use backward slashes; on UNIX, use forward slashes.
|
destination
|
Required
|
|
Absolute pathname of directory or file on web server. ColdFusion 5 and earlier: trailing slash in directory path is required. ColdFusion MX: trailing slash in directory path is optional. On Windows, use backward slashes; on UNIX, use forward slashes.
|
mode
|
Optional
|
|
Applies only to Solaris and HP-UX. Permissions. Octal values of UNIX chmod command. Assigned to owner, group, and other, respectively. For example:
- 644: Assigns read/write permission to owner; read permission to group and other
- 777: Assigns read/write/execute permission to all
|
attributes
|
Optional
|
|
One attribute (Windows) or a comma-delimited list of attributes (other platforms) to set on the file. If omitted, the file's attributes are maintained. Each value must be specified explicitly. For example, if you specify attributes = "readOnly" , all other attributes are overwritten.
|
charset
|
Optional
|
UTF-8
|
A Java character set name for the file contents. The following values are typically used:
- UTF-8
- ISO-8859-1
- UTF-16
- US-ASCII
- UTF-16BE
- UTF-16LE
For a list of character sets, see: http://www.w3.org/International/O-charset-lang.html
|
Example
The following example moves the keymemo.doc file from the c:\files\upload\ directory to the c:\files\memo\ directory on Windows:
<cffile
action = "move"
source = "c:\files\upload\keymemo.doc"
destination = "c:\files\memo\">
In this example, the destination directory is "memo."
Comments