User Guide

cffile 147
Example
This example creates a file with information a user entered in an HTML insert form:
<cffile action = "write"
file = "c:\files\updates\#Form.UpdateTitle#.txt"
output = "Created By: #Form.FullName#
Date: #Form.Date#
#Form.Content#">
If the user submitted a form with the following:
UpdateTitle = "FieldWork"
FullName = "World B. Frueh"
Date = "10/30/01"
Content = "We had a wonderful time in Cambridgeport."
ColdFusion would create a file named FieldWork.txt in the c:\files\updates\ directory and the file
would contain the following text:
Created By: World B. Frueh
Date: 10/30/01
We had a wonderful time in Cambridgeport.
attributes Optional 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", all other attributes are
overwritten.
readOnly
hidden
normal
charset Optional JVM
default file
character
set.
The character encoding in which the file contents is
encoded. The following list includes commonly used values:
utf-8
iso-8859-1
windows-1252
us-ascii
shift_jis
iso-2022-jp
euc-jp
euc-kr
big5
euc-cn
utf-16
For more information character encodings, see
www.w3.org/International/O-charset.html.
fixnewline Optional No Yes: changes embedded line-ending characters in string
variables to operating-system specific line endings.
No: (default) do not change embedded line-ending
characters in string variables.
Attribute Req/Opt Default Description