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 | 傳回本次查詢的執行時間 |