Programming ColdFusion

Name

CFSETTING

Synopsis

<CFSETTING ENABLECFOUTPUTONLY="Yes"

           SHOWDEBUGOUTPUT="Yes|No">
           CATCHEXCEPTIONSBYPATTERN="Yes|No">
CFML
<CFSETTING ENABLECFOUTPUTONLY="No"
           SHOWDEBUGOUTPUT="Yes|No">
           CATCHEXCEPTIONSBYPATTERN="Yes|No">

Controls whitespace, debugging output, and exception handling within ColdFusion templates.

When the ENABLECFOUTPUTONLY attribute is used, CFSETTING tags must occur in matched pairs where both a <CFSETTING ENABLECFOUTPUTONLY="Yes"> and a <CFSETTING ENABLECFOUTPUTONLY="No"> are present. CFSETTING tags may be nested any number of levels as long as there are always matching tag pairs. You don’t need to use paired CFSETTING tags with either the SHOWDEBUGOUTPUT or CATCHEXCEPTIONBYPATTERN attribute unless it is used in combination with an ENABLECFOUTPUTONLY attribute.

Attributes

ENABLECFOUTPUTONLY="Yes|No"

Specifying Yes results in the suppression of all HTML output (including whitespace) between CFSETTING tags. Optional. The default is No.

SHOWDEBUGOUTPUT="Yes|No"

Whether or not to suppress debugging information normally output to ColdFusion templates when debugging is turned on in the ColdFusion Administrator. Optional. The default is Yes.

CATCHEXCEPTIONSBYPATTERN=="Yes|No"

Whether or not to override structured exception handling. This attribute was introduced in ColdFusion 4.5 to handle incompatibility issues arising from changes to ColdFusion’s structured exception handling in Version 4.5. In Version 4.0.x of ColdFusion, exceptions caught with CFTRY/CATCH were ...