BackUp LevelNext

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.

The preferred syntax for file upload status variables uses the CFFILE prefix, 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 the "Resolving conflicting file name" section 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.
ServerFile
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, #File.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.


BackUp LevelNext

allaire

AllaireDoc@allaire.com
Copyright © 1998, Allaire Corporation. All rights reserved.