Displays the results of a database query or other operation.

To nest cfoutput tags, see the "Usage" section.

This tag must have a body.

This tag is also supported within <cfscript>

<cfoutput query=object group=string groupcasesensitive=boolean startrow=number maxrows=number endrow=number encodefor=string ><!--- body ---></cfoutput>
Attribute Description
object, optional

The name of the cfquery from which to draw data for the output section or the query itself.

string, optional

Specifies the query column to use when you group sets of records together. Use this attribute if you have retrieved a record set ordered on a certain query column. For example, if a record set is ordered according to "CustomerID" in the cfquery tag, you can group the output on "CustomerID." The group attribute, which is case sensitive, eliminates adjacent duplicates when the data is sorted by the specified field. See the groupCaseSensitive attribute for information about specifying a case insensitive grouping.

boolean, optional

Boolean indicating whether to group by case. The default value is YES; case is considered while grouping. If the query attribute specifies a query object that was generated by a case-insensitive SQL query, set the groupCaseSensitive attribute to NO to keep the recordset intact.

number, optional

Specifies the row from which to start output.

number, optional

Specifies the maximum number of rows to display in the output section. You cannot use this attribute together with the attribute endRow.

number, optional

Last row of query that is included. You cannot use this attribute together with the attribute maxRows.

string, optional

encode for what, valid values are:

  • css: for output inside Cascading Style Sheets (CSS)
  • dn: for output in LDAP Distinguished Names
  • html: for output inside HTML
  • html_attr: for output inside HTML Attributes
  • javascript: for output inside JavaScript
  • ldap: for output in LDAP queries
  • url: for output in URL
  • vbscript: for output inside vbscript
  • xml: for output inside XML
  • xml_attr: for output inside XML Attributes
  • xpath: for output in XPath


Simple example

<cfset a=3>
<cfset b=8>
<cfloop index="i" from="#a#" to="#b#">
<cfset test = queryNew("name,age","varchar,numeric",{name:["Susi","Urs","john","jerry"],age:[20,20,28,32]})>
<cfoutput query="test" maxrows="3">
<cfoutput query="test" startrow="2" endrow="3">
<cfoutput query="test" group="age">

See also