User Guide

420 Chapter 2: ColdFusion Tags
<!--- Perform the error catch. --->
<cfcatch type = "application">
<!--- Display your message. --->
<h3>You've Thrown an <b>Error</b></h3>
<cfoutput>
<!--- And the diagnostic feedback from the application server. --->
<p>#cfcatch.message#</p>
<p>The contents of the tag stack are:</p>
<cfloop
index = i
from = 1 to = #ArrayLen(cfcatch.tagContext)#>
<cfset sCurrent = #cfcatch.tagContext[i]#>
<br>#i# #sCurrent["ID"]#
(#sCurrent["LINE"]#,#sCurrent["COLUMN"]#)
#sCurrent["TEMPLATE"]#
</cfloop>
</cfoutput>
</cfcatch>
</cftry>
Example2
The following example shows how to throw an exception from a component method:
<cfcomponent>
<cffunction name="getEmp">
<cfargument name="lastName" required="yes">
<cfquery name="empQuery" datasource="cfdocexamples" >
SELECT LASTNAME, FIRSTNAME, EMAIL
FROM tblEmployees
WHERE LASTNAME LIKE '#arguments.lastName#'
</cfquery>
<cfif empQuery.recordcount LT 1>
<cfthrow type="noQueryResult"
message="No results were found. Please try again.">
<cfelse>
<cfreturn empQuery>
</cfif>
</cffunction>
</cfcomponent>
For an explanation of the example and more information, see Chapter 10, “Building and Using
ColdFusion Components” in ColdFusion MX Developer’s Guide.