User Guide

212 CFML Language Reference
CFTABLE
Builds a table in your ColdFusion page. Use the CFCOL tag to define column and row
characteristics for a table. CFTABLE renders data either as preformatted text, or, with
the HTMLTABLE attribute, as an HTML table. Use CFTABLE to create tables if you
don’t want to write your own HTML TABLE tag code, or if your data can be well
presented as preformatted text. See Usage for information about using the CFCOL tag
with the CFTABLE tag.
Syntax <CFTABLE QUERY="query_name"
MAXROWS="maxrows_table"
COLSPACING="number_of_spaces"
HEADERLINES="number_of_lines"
HTMLTABLE
BORDER
COLHEADERS
STARTROW="row_number">
</CFTABLE>
QUERY
Required. The name of the CFQUERY from which you want to draw data.
MAXROWS
Optional. Specifies the maximum number of rows you want to display in the table.
COLSPACING
Optional. Indicates the number of spaces to insert between columns (default is 2).
HEADERLINES
Optional. Indicates the number of lines to use for the table header (the default is 2,
which leaves one line between the headers and the first row of the table).
HTMLTABLE
Optional. Renders the table as an HTML 3.0 table.
BORDER
Optional. Adds a border to the table. Use only when you specify the HTMLTABLE
attribute for the table.
COLHEADERS
Optional. Displays headers for each column, as specified in the CFCOL tag.
STARTROW
Optional. Specifies the query row from which to start processing.