Displays execution time for a specified section of CFML code. ColdFusion MX displays the timing information along with any output produced by the timed code.
<cftimer
label= "text
"
type = "inline|outline|comment|debug" >
CFML statement(s)
</cftimer>
cfdump, cftrace; "Debugging and Troubleshooting Applications" in the ColdFusion Developer's Guide
ColdFusion MX 7: Added this tag.
Attribute |
Req/Opt |
Default |
Description |
---|---|---|---|
label |
Optional |
" " |
Label to display with timing information. |
type |
Optional |
debug |
|
Use this tag to determine how long it takes for a block of code to execute. You can nest cftimer tags.
This tag is useful for debugging CFML code during application development. In production, you can leave cftimer tags in your code as long as you have disabled the debugging option in the ColdFusion Administrator.
... <!--- type="inline"> ---> <cftimer label="Query and Loop Time Inline" type="inline"> <cfquery name="empquery" datasource="cfdocexamples"> SELECT * FROM Employees </cfquery> <cfloop query="empquery"> <cfoutput>#lastname#, #firstname#</cfoutput><br> </cfloop> </cftimer> <hr><br> <!--- type="outline" ---> <cftimer label="Query and CFOUTPUT Time with Outline" type="outline"> <cfquery name="coursequery" datasource="cfdocexamples"> SELECT * FROM CourseList </cfquery> <table border="1" width="100%"> <cfoutput query="coursequery"> <tr> <td>#Course_ID#</td> <td>#CorName#</td> <td>#CorLevel#</td> </tr> </cfoutput> </table> </cftimer> <hr><br> <!--- type="comment" ---> <cftimer label="Query and CFOUTPUT Time in Comment" type="comment"> <cfquery name="parkquery" datasource="cfdocexamples"> SELECT * FROM Parks </cfquery> <p>Select View > Source to see timing information</p> <table border="1" width="100%"> <cfoutput query="parkquery"> <tr> <td>#Parkname#</td> </tr> </cfoutput> </table> </cftimer> <hr><br> <!--- type="debug" ---> <cftimer label="Query and CFOUTPUT Time in Debug Output" type="debug"> <cfquery name="deptquery" datasource="cfdocexamples"> SELECT * FROM Departments </cfquery> <p>Scroll down to CFTimer Times heading to see timing information</p> <table border="1" width="100%"> <cfoutput query="deptquery"> <tr> <td>#Dept_ID#</td> <td>#Dept_Name#</td> </tr> </cfoutput> </table> </cftimer> ...