| 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, cfprocessingdirective, cfsilent; "Controlling debugging output with the cfsetting tag" in Chapter 18, "Debugging and Troubleshooting Applications," in ColdFusion MX Developer's Guide |
|||
| History
ColdFusion MX 6.1: Changed behavior: if the tag has a body, ColdFusion executes its contents. ColdFusion MX:
|
|||
| Usage
The cfsetting requestTimeout attribute replaces the use of requestTimeOut 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. If the debugging service is enabled and showDebugOutput =" Yes", the IsDebugMode function returns Yes; otherwise, No.
|
|||
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>
|
|||
| ENABLECFOUTPUTONLY | |
| Required | |
|
|
| SHOWDEBUGOUTPUT | |
| Optional | |
Default value: "Yes"
|
|
| REQUESTTIMEOUT | |
| Optional | |
|
|