Cferror - MACROMEDIA COLDFUSION MX 61-CFML Reference

cferror

Description
Displays a custom HTML page when an error occurs. This lets you maintain a consistent look
and feel among an application's functional and error pages.
Category
Exception handling
Syntax
<cferror
type = "a type"
template = "template_path"
mailTo = "email_address"
exception = "exception_type">
See also
cfrethrow, cfthrow,
History
ColdFusion MX: Deprecated the
and might cause an error, in later releases.
Attributes
Attribute Req/Opt
type Required
template Required
mailTo Optional
exception Optional
102 Chapter 2: ColdFusion Tags
tags, Extensibility tags,
cftry
monitor
Default Description
Type of error that the custom error page handles. The type
also determines how ColdFusion handles the error page. For
more information, see
error page,"
• exception: a exception of the type specified by the
exception
• validation: errors recognized by sever-side type validation.
• request: any encountered error.
Relative path to the custom error page. (A ColdFusion page
was formerly called a template.)
An E-mail address. This attribute is available on the error
page as the variable
automatically send anything to this address.
Any Type of exception that the tag handles:
• application: application exceptions
• database: database exceptions
• template: ColdFusion page exceptions
• security: security exceptions
• object: object exceptions
• missingInclude: missing include file exceptions
• expression: expression exceptions
• lock: lock exceptions
• custom_type: developer-defined exceptions, defined in the
cfthrow
• any: all exception types
For more information on exception types, see
on page 353
Application framework tags
option of the
exception
Chapter 14, "Specifying a custom
in Developing ColdFusion MX Applications.
attribute.
error.mailto
tag
attribute. It might not work,
. ColdFusion does not
cftry