cfcontent
89
Usage
To set the character encoding (character set) of generated output, use code such as the following:
<cfcontent type="text/html; charset=ISO-8859-1">
When ColdFusion processes an HTTP request, it determines the character encoding of the data
returned in the HTTP response. By default, ColdFusion returns character data using the Unicode
UTF-8 format (regardless of the value of an HTML
meta
tag in the page). You can use the
cfcontent
tag to override the default character encoding of the response. For example, to specify
the character encoding of the page output as Japanese EUC, use the
type
attribute, as follows:
<cfcontent type="text/html; charset=EUC-JP">
If you call the
cfcontent
tag from a custom tag, and you do not want the tag to discard the
current page when it is called from another application or custom tag, set
reset
= "no".
If a file delete operation is unsuccessful, ColdFusion throws an error.
If you use this tag after the
cfflush
tag on a page, ColdFusion throws an error. The following tag
can force most browsers to display a dialog that asks users whether they want to save the contents
of the file specified by the
cfcontent
tag as a with the filename specified by the
filename
value.
cfheader name="Content-Disposition" value="attachment;
filename=
filename.ext
"
For many file types, such as Excel documents, that Internet Explorer can display directly in the
browser, the browser displays the file without asking users whether to save it if you use a
cfheader
tag similar to the following:
<cfheader name="Content-Disposition" value="filename=
filename.ext
">
For more information on character encodings, see the following web pages:
•
www.w3.org/International/O-charset.html provides general information on character
encodings and the web, and has several useful links.
•
www.iana.org/assignments/character-sets is a complete list of character sets names used on the
Internet, maintained by the Internet Assigned Numbers Authority.
•
java.sun.com/j2se/1.3/docs/guide/intl/encoding.doc.html lists the character encodings that
Java, and therefore ColdFusion, can interpret. This list uses Java internal names, not the IANA
character encoding names that you use in the
SetEncoding
charset
parameter and other
ColdFusion attributes and parameters.
For a complete list of media types used on the Internet, see
www.iana.org/assignments/media-types/.
Example
<!--- This example shows the use of cfcontent to return the contents of the CF
Documentation page dynamically to the browser.
You might need to change the path and/or drive letter depending on how
ColdFusion is installed on your system.
Notice that the graphics do not display and the hyperlinks do not work,
because the html page uses relative filename references.
The root of the reference is the ColdFusion page, not the location of the
html page.
<cfcontent type = "text/html"
file = "C:\CFusionMX\wwwroot\cfdocs\dochome.htm"
deleteFile = "No">
<!--- This example shows how reset attribute changes text output. --->
Summary of Contents for COLDFUSION MX 61-CFML
Page 1: ...CFML Reference...
Page 16: ...16 Contents...
Page 32: ...32 Chapter 1 Reserved Words and Variables...
Page 160: ...160 Chapter 2 ColdFusion Tags html...
Page 245: ...cfmail 245 p input type Submit name form...
Page 299: ...cfreturn 299 cffunction cfcomponent...
Page 354: ...354 Chapter 2 ColdFusion Tags cfoutput cfcatch cftry...
Page 357: ...cfupdate 357 cftable cfif body html...
Page 362: ...362 Chapter 2 ColdFusion Tags cfloop MyDoc cfxml cfdump var MyDoc...
Page 397: ...ASin 397 br input type Text name sinNum size 25 p input type Submit name input type RESET form...
Page 486: ...486 Chapter 3 ColdFusion Functions input type Submit NAME form...
Page 492: ...492 Chapter 3 ColdFusion Functions b http_content x content b cfoutput...
Page 504: ...504 Chapter 3 ColdFusion Functions tr table form...
Page 519: ...IIf 519 cfoutput b...
Page 534: ...534 Chapter 3 ColdFusion Functions input type Submit name form...
Page 542: ...542 Chapter 3 ColdFusion Functions cfif cfif...
Page 547: ...IsStruct 547 cfcase cfswitch...
Page 550: ...550 Chapter 3 ColdFusion Functions IsWDDX returns IsWDDX packet br cfoutput...
Page 559: ...Left 559 option value 9 9 select input type Submit name Remove characters form...
Page 620: ...620 Chapter 3 ColdFusion Functions cfoutput cfloop...
Page 681: ...SetVariable 681 p Your variable varName p The value of varName is varNameValue cfoutput cfif...
Page 724: ...724 Chapter 3 ColdFusion Functions cfelse h3 Conversion error h3 cfif...
Page 743: ...XmlNew 743 cfscript cfdump var MyDoc...
Page 786: ...786 Chapter 5 ColdFusion Java CFX Reference...
Page 798: ...798 Chapter 6 WDDX JavaScript Objects...
Page 806: ...806 Chapter 7 ColdFusion ActionScript Functions...
