CFFILE ACTION = "RENAME" | |
Description | |
Renames or moves a file on the server. | |
Syntax<cffile action = "rename" source = "full_path_name" destination = "path_name" mode = "mode" attributes = "file_attributes_list"> |
|
See also | |
cfdirectory | |
History | |
See the History section of the main cffile tag page. | |
Usage | |
The rename action renames or move a file. The destination attribute must be a pathname, not just a new name for the file. If the destination is a directory, the file is moved and not renamed. | |
Example | |
The following example renames the file keymemo.doc to oldmemo.doc:
<cffile action = "rename" source = "c:\files\memo\keymemo.doc" destination = "c:\files\memo\oldmemo.doc"> |
ACTION | |
Required | |
Type of file manipulation that the tag performs. |
SOURCE | |
Required | |
Pathname of file to rename. If not an absolute path (starting a with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory, which is returned by the GetTempDirectory function. |
DESTINATION | |
Required | |
Destination file or directory. If not an absolute path, it is relative to the source directory. |
MODE | |
Optional | |
Applies only to UNIX and Linux. Permissions. Octal values of UNIX chmod command. Assigned to owner, group, and other. For example:
|
ATTRIBUTES | |
Optional | |
Applies to Windows. A comma-delimited list of attributes to set on the file. If omitted, the file's attributes are maintained. Each value must be specified explicitly. For example, if attributes = "readOnly", all other attributes are overwritten.
|