MACROMEDIA COLDFUSION MX 61-CFML Reference page 125

Attribute Req/Opt
mode Optional
attributes Optional
Usage
After a file upload is completed, you can get status information using file upload parameters. The
status parameters use the
parameters can be used anywhere other ColdFusion parameters can be used.
Note: The file prefix is deprecated, in favor of the cffile prefix. Do not use the file prefix in new
applications.
Tip: If your page is uploading a file that was selected on a form or was otherwise sent to your page via
a multipart/form-data HTTP message, you can determine the approximate size of the file by checking
the value of the CGI.content_length variable. This variable includes the file length plus the length
of any other request content.
The following file upload status parameters are available after an upload.
Parameter
attemptedServerFile
clientDirectory
clientFile
clientFileExt
clientFileName
contentSubType
contentType
dateLastAccessed
fileExisted
fileSize
fileWasAppended
fileWasOverwritten
fileWasRenamed
Default Description
Applies only to UNIX and Linux. Permissions. Octal values of
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
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"
overwritten.
• readOnly
• hidden
• normal (if you use this option with other attributes, it is
overridden by them)
prefix; for example,
cffile
Description
Initial name ColdFusion used when attempting to save a file
Directory location of the file uploaded from the client's system
Name of the file uploaded from the client's system
Extension of the uploaded file on the client system (without a period)
Name of the uploaded file on the client system (without an extension)
MIME content subtype of the saved file
MIME content type of the saved file
Date and time the uploaded file was last accessed
Whether the file already existed with the same path (Yes or No)
Size of the uploaded file
Whether ColdFusion appended uploaded file to a file (Yes or No)
Whether ColdFusion overwrote a file (Yes or No)
Whether uploaded file renamed to avoid a name conflict (Yes or No)
, all other attributes are
cffile.clientDirectory
. Status
cffile 125