Adobe COLDFUSION 9 Manual page 289

DEVELOPING COLDFUSION 9 APPLICATIONS
Developing CFML Applications
Attribute Description
Type The type of error that causes ColdFusion to display this page: Exception, Request, or Validation.
Exception Use only for the Exception type. The specific exception or exception category that causes the page to display. This
attribute can specify any of the types described in
Template The ColdFusion page to display.
MailTo (Optional) An e-mail address. The
page can use the
does not send any message itself.
The following tag specifies a custom error page for exceptions that occur in locking code and informs the
cferror
error page of the e-mail address to use to send a notification each time this type of error occurs:
<cferror type = "exception"
exception = "lock"
template = "../common/lockexcept.cfm"
mailto = "server@mycompany.com">
For detailed information on the
Creating an error application page
The following table lists the rules and considerations that apply to error application pages:
Type Considerations
Validation •
Cannot use CFML tags.
•
Can use HTML tags.
•
Can use the
variables by enclosing them with number signs (#).
•
Cannot use any other CFML variables.
Request •
Cannot use CFML tags.
•
Can use HTML tags.
•
Can use nine CFML error variables, such as
•
Cannot use other CFML variables.
Exception •
Can use full CFML syntax, including tags, functions, and variables.
•
Can use nine standard CFML Error variables and cfcatch variables. Use either
for both types of variables.
•
Can use other application-defined CFML variables.
•
To display any CFML variable, use the cfoutput tag.
The following table describes the variables available on error pages: Exception error pages can also use all of the
exception variables listed in the section
replace the prefix with
cfcatch
to it as .
error.message
cferror tag sets the error page
error.mailTo value in a message that tells the user to send an error notification. ColdFusion
tag, see the CFML Reference.
cferror
Error.InvalidFields , Error.validationHeader
"Exception information in cfcatch
or . For example, to use the exception message in an error page, refer
cferror error
Last updated 8/5/2010
"About ColdFusion exceptions" on page 277.
error.mailTo
, and Error.validationFooter
, by enclosing them with number signs.
Error.Diagnostics
Error
blocks" on page 289. To use these variables,
variable to this value. The error
or cferror as the prefix
284