MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX, Develop Manual

Page: 825 / 860

Using cffile 825
Moving, renaming, copying, and deleting server files
With
cffile
, you can create application pages to manage files on your web server. You can use
the tag to move files from one directory to another, rename files, copy a file, or delete a file.
The examples in the following table show static values for many of the attributes. However, the
value of all or part of any attribute in a cffile tag can be a dynamic parameter.
This example sets the ReadOnly flag bit for the uploaded file:
<cffile action="Copy"
source="c:\files\upload\keymemo.doc"
destination="c:\files\backup\"
attributes="ReadOnly">
Note: Ensure you include the trailing slash (\) when you specify the destination directory. Otherwise,
ColdFusion treats the last element in the pathname as a filename. This only applies to copy actions.
fileWasSaved Indicates (Yes or No) whether ColdFusion saved the uploaded file.
oldFileSize Size of the file that was overwritten in the file upload operation. Empty if
no file was overwritten.
serverDirectory Directory where the file was saved on the server.
serverFile Full name of the file saved on the server with the file extension; for
example, myfile.txt.
serverFileName Name of the file saved on the server without an extension; for example,
myfile.
serverFileExt Extension of the file saved on the server without a period; for example, txt
(not .txt).
timeCreated Date and time the uploaded file was created.
timeLastModified Date and time of the last modification to the uploaded file.
Action Example code
Move a file <
cffile
action="move"
source="c:\files\upload\KeyMemo.doc"
destination="c:\files\memo\">
Rename a file
<
cffile
action="rename"
source="c:\files\memo\KeyMemo.doc"
destination="c:\files\memo\OldMemo.doc">
Copy a file <
cffile
action="copy"
source="c:\files\upload\KeyMemo.doc"
destination="c:\files\backup\">
Delete a file
<
cffile
action="delete"
file="c:\files\upload\oldfile.txt">
Variable Description