|
cffile action = "move"
DescriptionMoves
a file from one location to another on the server.
Syntax<cffile
action = "move"
destination = "full pathname"
source = "full pathname"
attributes = "file attributes list"
charset = "character set option"
mode = "mode">
Note: You can
specify this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
HistorySee
the History section of the main cffile tag page.
Attributes
Attribute
|
Req/Opt
|
Default
|
Description
|
action
|
Required
|
|
Type of file manipulation that the tag performs.
|
destination
|
Required
|
|
Pathname of the destination directory or
file. If not an absolute path, it is relative to the source directory.
|
source
|
Required
|
|
Pathname of the file to move.
If
not an absolute path (starting 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.
|
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 you specify attributes="readOnly",
all other attributes are overwritten.
|
charset
|
Optional
|
JVM default file
character set
|
The character encoding in which the file
contents is encoded. The following list includes commonly used values:
utf-8
iso-8859-1
windows-1252
us-ascii
shift_jis
iso-2022-jp
euc-jp
euc-kr
big5
euc-cn
utf-16
For more information
character encodings, see www.w3.org/International/O-charset.html.
|
mode
|
Optional
|
|
Applies only to UNIX and Linux. Permissions.
Octal values of UNIX chmod command. Assigned to
owner, group, and other, respectively; for example:
|
ExampleThe
following example moves the keymemo.doc file from the c:\files\upload\ directory
to the c:\files\memo\ directory in Windows:
<cffile
action = "move"
source = "c:\files\upload\keymemo.doc"
destination = "c:\files\memo\">
In this example,
the destination directory is “memo.”
|