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. |