User Guide

cfsetting 321
cfsetting
Description
Controls aspects of page processing, such as the output of HTML code in pages.
Category
Page processing tags, Variable manipulation tags
Syntax
<cfsetting
enableCFoutputOnly = "Yes" or "No"
showDebugOutput = "Yes" or "No"
requestTimeOut = "value in seconds" >
See also
cfcache, cfflush, cfheader, cfhtmlhead, cfinclude, cfsilent
History
ColdFusion MX 6.1: Changed behavior: if the tag has a body, ColdFusion executes its contents.
ColdFusion MX:
• Added the requestTimeOut attribute.
• The catchExceptionsByPattern attribute is obsolete. It does not work, and causes an error,
in releases later than ColdFusion 5.
• Changed exception handling: the structured exception manager searches for the best-fit
cfcatch handler. (In earlier releases, an exception was handled by the first cfcatch block that
could handle an exception of its type.)
Attributes
Usage
The cfsetting requestTimeout attribute replaces the use of requestTmeOut within a URL. To
enforce a page timeout, detect the URL variable and use code such as the following to change the
page timeout:
<cfsetting RequestTimeout = "#URL.RequestTimeout#">
You can use this tag to manage whitespace in ColdFusion output pages.
Attribute Req/Opt Default Description
enableCFoutputOnly Required • Yes: blocks output of HTML that is outside
cfoutput tags
• No: displays HTML that is outside
cfoutput tags.
showDebugOutput Optional Yes • Yes: If debugging is enabled in the Administrator,
displays debugging information
• No: suppresses debugging information that would
otherwise display at end of generated page.
requestTimeout Optional • Integer; number of seconds. Time limit, after which
ColdFusion processes the page as an
unresponsive thread. Overrides the timeout set in
the ColdFusion Administrator.