
Contents > CFML Reference > ColdFusion Tags > cfheader

cfheader

Generates custom HTTP response headers to return to the client.

Data output tags, Page processing tags

<cfheader 
   name = "header_name"
   value = "header_value"
   charset="charset">
or
<cfheader 
   statusCode = "status_code"
   statusText = "status_text">

cfcache, cfflush, cfhtmlhead, cfinclude, cfsetting, cfsilent, cfcontent

ColdFusion MX 6.1: Changed behavior for the name attribute: cfheader name="Content-Disposition" uses the default file character encoding to encode this header's value, so the name of a file can include characters in the character encoding used in the file.

Attribute	Req/Opt	Default	Description
name	Required if `statusCode` not specified		Header name
value	Optional		HTTP header value
charset	Optional	UTF-8	The character encoding in which to encode the header value. 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.
statusCode	Required if `name` not specified		Number. HTTP status code
statusText	Optional		Explains status code

If you use this tag after the cfflush tag on a page, an error is thrown.

<h3>cfheader Example</h3>

<p>cfheader generates custom HTTP response headers to return to the client. 
<p>This example forces browser client to purge its cache of requested file. 
<cfheader name = "Expires" value = "#Now()#">


Contents > CFML Reference > ColdFusion Tags > cfheader

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Comments

James Ang said on Apr 21, 2004 at 3:34 PM :

The example generates invalid date/time string for the specified HTTP header. A better example is:

<cfheader name="Expires" value="#GetHttpTimeString(Now())#">

www.tolafghan.com said on May 5, 2004 at 9:37 PM :

kha;adj;ajf;jsdsf

No screen name said on Jun 7, 2004 at 3:11 PM :

Yes,
<cfheader name="Expires" value="#GetHttpTimeString(Now())#">
<cfheader name="Pragma" value="no-cache">

actually expires a posted page when back button is used, where meta tags seem buggy. thanks

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/tags-p56.htm