|
cfheader
DescriptionGenerates
custom HTTP response headers to return to the client.
Syntax<cfheader
charset="character set"
name = "header name"
value = "header value">
OR
<cfheader
statusCode = "status code"
statusText = "status text">
Note: You
can specify this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
HistoryColdFusion
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.
Attributes
Attribute
|
Req/Opt
|
Default
|
Description
|
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
about character encodings, see www.w3.org/International/O-charset.html.
|
name
|
Required if statusCode not
specified
|
|
Header name.
|
statusCode
|
Required if name not specified
|
|
Number. HTTP status code.
|
statusText
|
Optional
|
|
Explains the status code.
|
value
|
Optional
|
|
HTTP header value.
|
UsageIf you
use this tag after the cfflush tag on a page, an
error is thrown.
Example<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="#GetHttpTimeString(Now())#">
|