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.)
|
|
|
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.
|
If you nest cfsetting tags: to make HTML output visible, you must match each enableCFoutputOnly = "Yes" statement with an enableCFoutputOnly = "No" statement. For example, after five enableCFoutputOnly = "Yes" statements, to enable HTML output, you must have five corresponding enableCFoutputOnly = "No" statements.
|
If HTML output is enabled (no matter how many enableCFoutputOnly = "No" statements have been processed) the first enableCFoutputOnly = "Yes" statement blocks output.
Note: |
If the debugging service is enabled and showDebugOutput =" Yes", the IsDebugMode function returns Yes; otherwise, No. ColdFusion MX 6.1 allows a </cfsetting> end tag; however, this end tag does not effect processing. The cfsetting attributes affect code inside and outside the cfsetting tag body. ColdFusion MX ignored code between cfsetting start and end tags. |
|
|
Example<p>CFSETTING is used to control the output of HTML code in ColdFusion pages.
This tag can be used to minimize the amount of generated whitespace.
<cfsetting enableCFoutputOnly = "Yes">
This text is not shown
<cfsetting enableCFoutputOnly = "No">
<p>This text is shown
<cfsetting enableCFoutputOnly = "Yes">
<cfoutput>
<p>Text within cfoutput is always shown
</cfoutput>
<cfsetting enableCFoutputOnly = "No">
<cfoutput>
<p>Text within cfoutput is always shown
</cfoutput>
|