MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 111 / 806

cffile 111
•
Changed directory path requirements for the
destination
attribute: a directory path that you
specify in the
destination
attribute does not require a trailing slash.
•
Deprecated the
system
value of the
attributes
attribute.
•
Deprecated the
temporary
value of the
attributes
attribute. In ColdFusion MX, it is a
synonym for
normal
. It might not work in later releases.
•
Changed the
action
attribute options
read
,
write
,
append
and
move
: they support a new
attribute,
charset
.
•
The
archive
value of the
attributes
attribute is obsolete and has no effect.
Example
<!--- This shows how to write, read, update, and delete a file using CFFILE
--->
This is a view-only example.
<!---
<cfif IsDefined("form.formsubmit") is "Yes">
<!--- form has been submitted, now do the action --->
<cfif form.action is "new">
<!--- make a new file --->
<cffile action="Write"
file="#GetTempDirectory()#foobar.txt"
output="#form.the_text#">
</cfif>
<cfif form.action is "read">
<!--- read existing file --->
<cffile action="Read"
file="#GetTempDirectory()#foobar.txt"
variable="readText">
</cfif>
<cfif form.action is "add">
<!--- update existing file --->
<cffile action="Append"
file="#GetTempDirectory()#foobar.txt"
output="#form.the_text#">
</cfif>
<cfif form.action is "delete">
<!--- delete existing file --->
<cffile action="Delete"
file="#GetTempDirectory()#foobar.txt">
</cfif>
</cfif>
<!--- set some variables --->
<cfparam name="fileExists" default="no">
<cfparam name="readText" default="">
<!--- first, check if canned file exists --->
<cfif FileExists("#GetTempDirectory()#foobar.txt") is "Yes">
<cfset fileExists="yes">
</cfif>
<!--- now, make the form that runs the example --->
<form action="index.cfm" method="POST">
<h4>Type in some text to include in your file:</h4> <p>
<cfif fileExists is "yes">
A file exists (foobar.txt, in <cfoutput>#GetTempDirectory()#</cfoutput>).
You may add to it, read from it, or delete it.
</cfif> <
!--- if reading from a form, let that information display in textarea --->