Cfcatch - MACROMEDIA COLDFUSION MX 61-CFML Reference

cfcatch

Description
Used inside a
cftry
Exceptions are events that disrupt the normal flow of instructions in a ColdFusion page, such as
failed database operations, missing include files, and developer-specified events.
Category
Exception handling tags
Syntax
<cfcatch type = "exceptiontype">
Exception processing code here
</cfcatch>
See also
cftry, cferror, cfrethrow, cfthrow,
ColdFusion MX Applications
History
ColdFusion MX:
•
Changed SQLSTATE value behavior: the SQLSTATE return value in a
on the database driver type:
Type 1 (JDBC-ODBC bridge): the value is the same as in ColdFusion 5
Type 4 (100% Java, no native methods): the value might be different
If your application depends on SQLSTATE values for flow control, the application might
produce unexpected behavior with ColdFusion MX.
•
Changed the behavior of this tag when
tag with
cfcatch
other tests are executed before it. ColdFusion finds the best-match
•
Changed the behavior of the
equivalent to the
•
Changed object modification: you cannot modify the object returned by
•
Changed thrown exceptions: the
SEARCHENGINE exception. In earlier releases, an error in processing these tags threw only
an UNKNOWN exception.
64 Chapter 2: ColdFusion Tags
tag. Together, they catch and process exceptions in ColdFusion pages.
, to do so in the last
type="any"
cfscript
and tags.
cftry cfcatch
cfcollection
Chapter 14, "Handling Errors,"
: it is not necessary, when you include a
type="any"
tag in the block, to ensure that all
cfcatch
tag: it includes and
try
, , and
cfindex
in Developing
tag depends
cfcatch
block.
cfcatch
statements that are
catch
.
cfcatch
tags can throw the
cfsearch