User Guide

ManualsBrandsMacromedia ManualsOtherCOLDFUSION MX 61-CFML REFERENCE

cfcontent 89

Usage

To set the character encoding (character set) of generated output, use code such as the following:

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:

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:

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