MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 73 / 608

Chapter 1: ColdFusion Tags 49
Evaluating the results of a file upload
After a file upload is completed, you can retrieve status information using file upload
parameters. This status information includes a wide range of data about the file, such
as the file’s name and the directory where it was saved. File upload status parameters
use the "File " prefix, for example,
File.ClientDirectory
. The file status
parameters can be used anywhere other ColdFusion parameters can be used.
The following file upload status parameters are available after an upload.
File Upload Parameters
Parameter Description
AttemptedServerFile
Initial name ColdFusion used attempting to
save a file, for example, myfile.txt.
ClientDirectory
Directory location of the file uploaded from
the client’s system.
ClientFile
Name of the file uploaded from the client’s sys-
tem.
ClientFileExt
Extension of the uploaded file on the client’s
system without a period, for example, txt not
.txt.
ClientFileName
Filename without an extension of the
uploaded file on the client’s system.
ContentSubType MIME content subtype of the saved file.
ContentType MIME content type of the saved file.
DateLastAccessed Date and time the uploaded file was last
accessed.
FileExisted
Indicates (Yes or No) whether or not the file
already existed with the same path.
FileSize
Size of the uploaded file.
FileWasAppended
Indicates (Yes or No) whether or not ColdFu-
sion appended the uploaded file to an existing
file.
FileWasOverwritten
Indicates (Yes or No) whether or not ColdFu-
sion overwrote a file.