CFQUERY標籤

CFQUERY標籤

<CFQUERY NAME="query_name" DATESOURCE="ds_name" DBTYPE="type" DBSERVER="dbms" DBNAME="database name" USERNAME="username" PASSWORD="password" MAXROWS="number" BLOCKFACTOR="blocksize" TIMEOUT="milliseconds" CACHEDAFTER="date" CACHEDWITHIN="timespan" DEBUG="Yes/No">

SQL statements 資料庫查詢的語法敍述式

</CFQUERY>

CFQUERY標籤的完整語法：

語法名稱	說明
NAME = "query_name"	查詢結果的資料集名稱
DATASOURCE = "ds_name"	資料庫來源名稱
DBTYPE = "type"	資料庫的驅動程式名稱
DBSERVER = "dbms"	native database 或 SQLOLEDB 的伺服器主機名稱
DBNAME = "database name"	使用 Sybase 及 SQLOLEDB 的伺服器主機名稱
USERNAME = "username"	連結資料庫的使用者名稱
PASSWORD = "password"	連結資料庫的使用者密碼
MAXROWS = "number"	傳回的最大筆數
BLOCKFACTOR = "blocksize"	設定資料庫伺服器回傳的區段量
TIMEOUT = "milliseconds"	當連結多久時間後即中斷執行
CACHEDAFTER = "date"	設定快取的起始日期
CACHEDWITHIN = "timespan"	設定快取的時間間隔
DEBUG = "Yes/No"	設定是否開啟除錯功能

CFQUERY查詢的基本傳回變數值：

變數名稱	說明
query_name.recordCount	傳回本次查詢的記錄筆數
query_name.currentRow	傳回前資料所在的記錄編號
query_name.cloumnList	傳回本次查詢的資料的欄位清單
cfquery.ExecutionTime	傳回本次查詢的執行時間