User Guide

800 Chapter 7: ColdFusion ActionScript Functions
CF.query
Description
Performs queries against ColdFusion data sources.
Return value
Returns a RecordSet object.W
Syntax
CF.query
({
datasource:"data source name",
sql:"SQL stmts",
username:"username",
password:"password",
maxrows:number,
timeout:milliseconds
})
Arguments
Usage
You can code the CF.query function using named or positional arguments. You can invoke all
supported arguments using the named argument style, as follows:
CF.query({datasource:"datasource", sql:"sql stmt",
username:"username", password:"password", maxrows:"maxrows",
timeout:"timeout"});
Note: The named argument style uses curly braces {} to surround the function arguments.
Positional argument style, which is a shorthand coding style, does not support all arguments. Use
the following syntax to code the CF.query function using positional arguments:
CF.query(datasource, sql);
CF.query(datasource, sql, maxrows);
CF.query(datasource, sql, username, password);
CF.query(datasource, sql, username, password, maxrows);
Note: Do not use curly braces {} with positional arguments.
You can manipulate the record set returned by the CF.query function using methods in the
RecordSet ActionScript class. The following are some of the methods available in the RecordSet
class:
Arguments Req/Opt Description
datasource Required Name of the data source from which the query retrieves data.
sql Required SQL statement.
username Optional Username. Overrides the username specified in the data source setup.
password Optional Password. Overrides the password specified in the data source setup.
maxrows Optional Maximum number of rows to return in the record set.
timeout Optional Maximum number of seconds for the query to execute before returning
an error indicating that the query has timed out. Can only be used in
named arguments.