Evaluating the Results of a File Upload

After a file upload is completed, you can retrieve status information using file upload variables. 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.

Although you can use either the File or CFFILE prefix, for file uplodad status variables, CFFILE is preferred, for example, CFFILE.ClientDirectory. (The File prefix is retained for backward compatibility.) The file status variables can be used anywhere that ColdFusion variables are used.

The following file upload status variables are available after an upload.

File Upload Variables 
Parameter Description
AttemptedServerFile Initial name ColdFusion used attempting to save a file, for example, myfile.txt. See "Resolving conflicting file names" above.
ClientDirectory Directory location of the file uploaded from the client's system.
ClientFile Name of the file uploaded from the client's system, such as myfile.txt.
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, such as gif for image/gif.
ContentType MIME content type of the saved file, such as image for image/gif.
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 ColdFusion appended the uploaded file to an existing file.
FileWasOverwritten Indicates (Yes or No) whether or not ColdFusion overwrote a file.
FileWasRenamed Indicates (Yes or No) whether or not the uploaded file was renamed to avoid a name conflict.
FileWasSaved Indicates (Yes or No) whether or not ColdFusion saved a file.
OldFileSize Size of a file that was overwritten in the file upload operation.
ServerDirectory Directory of the file actually saved on the server.
ServeFile Filename of the file actually saved on the server.
ServerFileExt Extension of the uploaded file on the server, without a period, for example, txt not.txt.
ServerFileName Filename, without an extension, of the uploaded file on the server.
TimeCreated Time the uploaded file was created.
TimeLastModified Date and time of the last modification to the uploaded file.

Use the File prefix to refer to these variables, for example, #CFFILE.FileExisted#.

Note File status variables are read-only. They are set to the results of the most recent CFFILE operation. If two CFFILE tags execute, the results of the first are overwritten by the subsequent CFFILE operation.