ColdFusion 9.0 Resources |
cftraceDescriptionDisplays and logs debugging data about the state of an application at the time the cftrace tag executes. Tracks run-time logic flow, variable values, and execution time. Displays output at the end of the request or in the debugging section at the end of the request; or, in Dreamweaver MX and later, in the Server Debug tab of the Results window. ColdFusion logs cftrace output to the file logs\cftrace.log, in the ColdFusion installation directory. Note: To permit this tag to execute, enable debugging
in the ColdFusion Administrator. Optionally, to report trace summaries,
enable the Trace section
Syntax<cftrace abort = "yes|no" category = "string" inline = "yes|no" text = "string" type = "format" var = "variable name"> </cftrace> Note: You can specify
this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
See alsocfdump, cferror, cfrethrow, cftimer, cftry; Debugging and Troubleshooting Applications in the Developing ColdFusion Applications Attributes
UsageYou cannot put application code within this tag. (This avoids problems that can occur if you disable debugging.) This tag is useful for debugging CFML code during application development. You can display cftrace tag output in the following ways:
ExampleThe following example traces a FORM variable that is evaluated by a cfif block: <cftrace var="FORM.variable" text="doing equivalency check for FORM.variable" category="form_vars" inline="true"> <cfif isDefined("FORM.variable") AND #FORM.variable# EQ 1> <h1>Congratulations, you're a winner!</h1> <cfelse> <h1>Sorry, you lost!</h1> </cfif> |