Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 420

DEVELOPING COLDFUSION 9 APPLICATIONS
Accessing and Using Data
In your CFML code, use these variables as if they are columns in a database table. Use the
the name of the structure that ColdFusion populates with these variables. You then use that structure name to refer to
the query variables as the following example shows:
Output information about the query on your page
1 Edit emplist.cfm so that it appears as follows:
<cfset Emp_ID = 1>
<cfquery name="EmpList" datasource="cfdocexamples" result="tmpResult">
SELECT FirstName, LastName, Salary, Contract
FROM Employee
WHERE Emp_ID = <cfqueryPARAM value = "#Emp_ID#"
</cfquery>
<cfoutput query="EmpList">
#EmpList.FirstName#, #EmpList.LastName#, #EmpList.Salary#, #EmpList.Contract#<br>
</cfoutput> <br>
<cfoutput>
The query returned #tmpResult.RecordCount# records.<br>
The query columns are:#tmpResult.ColumnList#.<br>
The SQL is #tmpResult.SQL#.<br>
Whether the query was cached: #tmpResult.Cached#.<br>
Query execution time: #tmpResult.ExecutionTime#.<br>
</cfoutput>
<cfdump var="#tmpResult.SQLParameters#">
2 Save the file and view it in your web browser:
The number of employees now appears below the list of employees. If necessary, refresh your browser and scroll to
see the RecordCount output.
Reviewing the code
You now display the number of records retrieved in the query. The following table describes the code and its function:
Code
<cfoutput>
The query returned
#EmpList.RecordCount#
records.
</cfoutput>
Query variable notes and considerations
When using query variables, keep in mind the following guidelines:
• Reference the query variable within a
• Surround the query variable reference with number signs (#) so that ColdFusion knows to replace the variable
name with its current value.
• Do not use the
cfoutput
do, you get one copy of the output for each row. Instead, prefix the variable with the name of the query.
CFSQLType = "CF_SQL_INTEGER">
Description
Displays what follows.
Displays the text "The query returned".
Displays the number of records retrieved in the EmpList query.
Displays the text "records."
Ends the cfoutput block.
block so that ColdFusion outputs the query variable value to the page.
cfoutput
tag attribute when you output the
query
Last updated 1/20/2012
attribute to specify
result
or
RecordCount ColumnList
415
property. If you