# CActiveRecord API 速查清單（中文版 · Yii 1.1）

> 來源：[CActiveRecord | Yii 1.1 API](https://www.yiiframework.com/doc/api/1.1/CActiveRecord)  
> 指南：[Active Record（英文）](https://www.yiiframework.com/doc/guide/1.1/en/database.ar)  
> 原始碼：[CActiveRecord.php](https://github.com/yiisoft/yii/blob/master/framework/db/ar/CActiveRecord.php)

## 類別概要

| 項目 | 說明 |
| --- | --- |
| 套件 | `system.db.ar` |
| 繼承 | `CActiveRecord` → `CModel` → `CComponent` |
| 實作介面 | Traversable、ArrayAccess、IteratorAggregate |
| 說明 | Active Record（活動記錄）ORM 基底類別，代表資料表中的一筆或多筆記錄 |

---

## 目錄

- [公開屬性](#公開屬性-public-properties)
- [公開方法（分類）](#公開方法--依用途分類)
- [公開方法（完整）](#公開方法--完整列表含繼承)
- [受保護方法](#受保護方法-protected-methods)
- [事件](#事件-events)

---

## 公開屬性 (Public Properties)

| 屬性 | 說明 | 定義於 |
| --- | --- | --- |
| **[attributes](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#attributes-detail)** | 回傳所有資料欄位屬性的值（不含關聯物件） | CActiveRecord |
| **[commandBuilder](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#commandBuilder-detail)** | 回傳此 AR 使用的指令建構器 | CActiveRecord |
| **[db](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#db-detail)** | 所有 Active Record 類別共用的預設資料庫連線 | CActiveRecord |
| **[dbConnection](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#dbConnection-detail)** | 回傳 Active Record 使用的資料庫連線 | CActiveRecord |
| **[dbCriteria](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#dbCriteria-detail)** | 回傳與此模型關聯的查詢條件（`CDbCriteria`） | CActiveRecord |
| [errors](https://www.yiiframework.com/doc/api/1.1/CModel#errors-detail) | 回傳全部或單一屬性的驗證錯誤 | CModel |
| **[isNewRecord](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#isNewRecord-detail)** | 回傳目前記錄是否為新記錄（尚未寫入資料庫） | CActiveRecord |
| [iterator](https://www.yiiframework.com/doc/api/1.1/CModel#iterator-detail) | 回傳用於遍歷模型屬性的迭代器 | CModel |
| **[metaData](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#metaData-detail)** | 回傳此 AR 的中繼資料 | CActiveRecord |
| **[oldPrimaryKey](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#oldPrimaryKey-detail)** | 回傳舊的主鍵值（find 後填入，手動改主鍵也不變） | CActiveRecord |
| **[primaryKey](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#primaryKey-detail)** | 回傳主鍵值 | CActiveRecord |
| [safeAttributeNames](https://www.yiiframework.com/doc/api/1.1/CModel#safeAttributeNames-detail) | 回傳可安全大量指派（mass assignment）的屬性名稱 | CModel |
| [scenario](https://www.yiiframework.com/doc/api/1.1/CModel#scenario-detail) | 回傳模型目前使用的情境（scenario） | CModel |
| **[tableAlias](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#tableAlias-detail)** | 回傳 find 類方法使用的資料表別名 | CActiveRecord |
| **[tableSchema](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#tableSchema-detail)** | 回傳此 AR 所屬資料表的中繼資料 | CActiveRecord |
| [validatorList](https://www.yiiframework.com/doc/api/1.1/CModel#validatorList-detail) | 回傳模型中宣告的所有驗證器 | CModel |
| [validators](https://www.yiiframework.com/doc/api/1.1/CModel#validators-detail) | 回傳目前 [scenario](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#scenario) 適用的驗證器 | CModel |

---

## 公開方法 — 依用途分類

### 模型與資料表設定

- [`tableName()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#tableName-detail) — 回傳對應資料表名稱（子類別須覆寫） *(定義於 CActiveRecord)*
- [`primaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#primaryKey-detail) — 回傳對應資料表的主鍵欄位定義 *(定義於 CActiveRecord)*
- [`model()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#model-detail) — 回傳指定 AR 類別的靜態模型實例（常用 `User::model()`） *(定義於 CActiveRecord)*
- [`relations()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#relations-detail) — 宣告關聯物件（子類別須覆寫） *(定義於 CActiveRecord)*
- [`attributeNames()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#attributeNames-detail) — 回傳模型所有屬性名稱清單 *(定義於 CActiveRecord)*
- [`defaultScope()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#defaultScope-detail) — 回傳預設命名 scope，會隱含套用於所有查詢 *(定義於 CActiveRecord)*
- [`scopes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#scopes-detail) — 回傳命名 scope 的宣告 *(定義於 CActiveRecord)*

### 查詢 (Find)

- [`find()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#find-detail) — 依條件查詢單筆記錄 *(定義於 CActiveRecord)*
- [`findAll()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAll-detail) — 依條件查詢多筆記錄 *(定義於 CActiveRecord)*
- [`findByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findByPk-detail) — 依主鍵查詢單筆記錄 *(定義於 CActiveRecord)*
- [`findAllByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAllByPk-detail) — 依主鍵查詢多筆記錄 *(定義於 CActiveRecord)*
- [`findByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findByAttributes-detail) — 依指定屬性值查詢單筆記錄 *(定義於 CActiveRecord)*
- [`findAllByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAllByAttributes-detail) — 依指定屬性值查詢多筆記錄 *(定義於 CActiveRecord)*
- [`findBySql()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findBySql-detail) — 以 SQL 查詢單筆記錄 *(定義於 CActiveRecord)*
- [`findAllBySql()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAllBySql-detail) — 以 SQL 查詢多筆記錄 *(定義於 CActiveRecord)*
- [`exists()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#exists-detail) — 檢查是否存在符合條件的資料列 *(定義於 CActiveRecord)*
- [`count()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#count-detail) — 統計符合查詢條件的資料列筆數 *(定義於 CActiveRecord)*
- [`countByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#countByAttributes-detail) — 統計符合指定屬性值的資料列筆數 *(定義於 CActiveRecord)*
- [`countBySql()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#countBySql-detail) — 以 SQL 統計資料列筆數 *(定義於 CActiveRecord)*

### 關聯與 Scope

- [`with()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#with-detail) — 指定要預先載入（eager load）的關聯物件 *(定義於 CActiveRecord)*
- [`together()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#together-detail) — 將 [CDbCriteria::together](https://www.yiiframework.com/doc/api/1.1/CDbCriteria#together) 設為 true *(定義於 CActiveRecord)*
- [`cache()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#cache-detail) — 設定查詢快取參數 *(定義於 CActiveRecord)*
- [`resetScope()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#resetScope-detail) — 重設已套用的 scope 與查詢條件 *(定義於 CActiveRecord)*
- [`applyScopes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#applyScopes-detail) — 將查詢 scope 套用到指定條件 *(定義於 CActiveRecord)*
- [`getRelated()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getRelated-detail) — 回傳關聯記錄（可延遲載入） *(定義於 CActiveRecord)*
- [`hasRelated()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#hasRelated-detail) — 回傳指定關聯是否已載入 *(定義於 CActiveRecord)*
- [`getActiveRelation()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getActiveRelation-detail) — 回傳此 AR 類別宣告的具名關聯 *(定義於 CActiveRecord)*
- [`getActiveFinder()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getActiveFinder-detail) — 依 `with` 選項建立新的 Active Finder 實例 *(定義於 CActiveRecord)*

### 儲存與刪除

- [`save()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#save-detail) — 儲存目前記錄（新增或更新） *(定義於 CActiveRecord)*
- [`insert()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#insert-detail) — 依目前屬性新增一筆資料列 *(定義於 CActiveRecord)*
- [`update()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#update-detail) — 更新此記錄對應的資料列 *(定義於 CActiveRecord)*
- [`delete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#delete-detail) — 刪除此記錄對應的資料列 *(定義於 CActiveRecord)*
- [`saveAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#saveAttributes-detail) — 僅儲存指定屬性（不觸發完整驗證流程） *(定義於 CActiveRecord)*
- [`saveCounters()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#saveCounters-detail) — 儲存目前 AR 物件的一個或多個計數器欄位 *(定義於 CActiveRecord)*
- [`updateCounters()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#updateCounters-detail) — 更新一個或多個計數器欄位（可批次） *(定義於 CActiveRecord)*
- [`updateAll()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#updateAll-detail) — 依條件批次更新記錄 *(定義於 CActiveRecord)*
- [`updateByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#updateByPk-detail) — 依主鍵批次更新記錄 *(定義於 CActiveRecord)*
- [`deleteAll()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#deleteAll-detail) — 依條件批次刪除記錄 *(定義於 CActiveRecord)*
- [`deleteAllByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#deleteAllByAttributes-detail) — 依屬性值批次刪除記錄 *(定義於 CActiveRecord)*
- [`deleteByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#deleteByPk-detail) — 依主鍵刪除記錄 *(定義於 CActiveRecord)*

### 屬性存取

- [`getAttribute()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getAttribute-detail) — 回傳指定屬性值 *(定義於 CActiveRecord)*
- [`setAttribute()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setAttribute-detail) — 設定指定屬性值 *(定義於 CActiveRecord)*
- [`getAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getAttributes-detail) — 回傳所有資料欄位屬性值 *(定義於 CActiveRecord)*
- [`setAttributes()`](https://www.yiiframework.com/doc/api/1.1/CModel#setAttributes-detail) — 大量指派屬性值 *(定義於 CModel)*
- [`hasAttribute()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#hasAttribute-detail) — 檢查是否具有指定屬性 *(定義於 CActiveRecord)*
- [`getAttributeLabel()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getAttributeLabel-detail) — 回傳指定屬性的顯示標籤 *(定義於 CActiveRecord)*
- [`equals()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#equals-detail) — 比較兩筆 Active Record 是否相同 *(定義於 CActiveRecord)*
- [`refresh()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#refresh-detail) — 從資料庫重新載入最新資料 *(定義於 CActiveRecord)*

### 主鍵與狀態

- [`getPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getPrimaryKey-detail) — 回傳主鍵值 *(定義於 CActiveRecord)*
- [`setPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setPrimaryKey-detail) — 設定主鍵值 *(定義於 CActiveRecord)*
- [`getOldPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getOldPrimaryKey-detail) — 回傳舊主鍵值 *(定義於 CActiveRecord)*
- [`setOldPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setOldPrimaryKey-detail) — 設定舊主鍵值 *(定義於 CActiveRecord)*
- [`getIsNewRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getIsNewRecord-detail) — 回傳是否為新記錄（尚未寫入資料庫） *(定義於 CActiveRecord)*
- [`setIsNewRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setIsNewRecord-detail) — 設定是否為新記錄 *(定義於 CActiveRecord)*
- [`populateRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#populateRecord-detail) — 依給定屬性建立 AR 實例 *(定義於 CActiveRecord)*
- [`populateRecords()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#populateRecords-detail) — 依輸入資料建立 AR 實例清單 *(定義於 CActiveRecord)*

### 資料庫與中繼

- [`getDbConnection()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getDbConnection-detail) — 回傳 AR 使用的資料庫連線 *(定義於 CActiveRecord)*
- [`getCommandBuilder()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getCommandBuilder-detail) — 回傳此 AR 使用的指令建構器 *(定義於 CActiveRecord)*
- [`getDbCriteria()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getDbCriteria-detail) — 回傳與此模型關聯的查詢條件 *(定義於 CActiveRecord)*
- [`setDbCriteria()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setDbCriteria-detail) — 設定目前模型的查詢條件 *(定義於 CActiveRecord)*
- [`getMetaData()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getMetaData-detail) — 回傳此 AR 的中繼資料 *(定義於 CActiveRecord)*
- [`refreshMetaData()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#refreshMetaData-detail) — 重新整理此 AR 類別的中繼資料 *(定義於 CActiveRecord)*
- [`getTableSchema()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getTableSchema-detail) — 回傳此 AR 所屬資料表結構中繼資料 *(定義於 CActiveRecord)*
- [`getTableAlias()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getTableAlias-detail) — 回傳 find 方法使用的資料表別名 *(定義於 CActiveRecord)*
- [`setTableAlias()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setTableAlias-detail) — 設定查詢使用的資料表別名 *(定義於 CActiveRecord)*

### 魔術方法

- [`__construct()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__construct-detail) — 建構子（通常勿覆寫，請用 `init()`） *(定義於 CActiveRecord)*
- [`__get()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__get-detail) — PHP getter 魔術方法（屬性／關聯存取） *(定義於 CActiveRecord)*
- [`__set()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__set-detail) — PHP setter 魔術方法 *(定義於 CActiveRecord)*
- [`__isset()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__isset-detail) — 檢查屬性值是否為 null *(定義於 CActiveRecord)*
- [`__unset()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__unset-detail) — 將元件屬性設為 null *(定義於 CActiveRecord)*
- [`__call()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__call-detail) — 呼叫非類別方法（實作命名 scope、關聯存取） *(定義於 CActiveRecord)*
- [`__sleep()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__sleep-detail) — PHP 序列化魔術方法 *(定義於 CActiveRecord)*

### 生命週期與內部

- [`init()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#init-detail) — 初始化模型（建構後呼叫） *(定義於 CActiveRecord)*
- [`beforeFindInternal()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeFindInternal-detail) — 內部呼叫 [beforeFind](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeFind) *(定義於 CActiveRecord)*
- [`afterFindInternal()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterFindInternal-detail) — 內部呼叫 [afterFind](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterFind) *(定義於 CActiveRecord)*
- [`addRelatedRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#addRelatedRecord-detail) — **請勿呼叫**；由 [CActiveFinder](https://www.yiiframework.com/doc/api/1.1/CActiveFinder) 內部使用 *(定義於 CActiveRecord)*
- [`offsetExists()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#offsetExists-detail) — 檢查指定偏移位置是否有元素（ArrayAccess） *(定義於 CActiveRecord)*

### 事件註冊

- [`onBeforeSave()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeSave-detail) — 儲存記錄前觸發的事件 *(定義於 CActiveRecord)*
- [`onAfterSave()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterSave-detail) — 儲存記錄後觸發的事件 *(定義於 CActiveRecord)*
- [`onBeforeDelete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeDelete-detail) — 刪除記錄前觸發的事件 *(定義於 CActiveRecord)*
- [`onAfterDelete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterDelete-detail) — 刪除記錄後觸發的事件 *(定義於 CActiveRecord)*
- [`onBeforeFind()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeFind-detail) — AR 執行 find 前觸發的事件 *(定義於 CActiveRecord)*
- [`onAfterFind()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterFind-detail) — find 建立記錄實例後觸發的事件 *(定義於 CActiveRecord)*
- [`onBeforeCount()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeCount-detail) — AR 執行 count 前觸發的事件 *(定義於 CActiveRecord)*

---

## 公開方法 — 完整列表（含繼承）

共 131 項。**粗體**為 `CActiveRecord` 本類定義。

- **[`__call()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__call-detail)** — 呼叫非類別方法（命名 scope、關聯） *(定義於 CActiveRecord)*
- **[`__construct()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__construct-detail)** — 建構子 *(定義於 CActiveRecord)*
- **[`__get()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__get-detail)** — PHP getter 魔術方法 *(定義於 CActiveRecord)*
- **[`__isset()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__isset-detail)** — 檢查屬性值是否為 null *(定義於 CActiveRecord)*
- **[`__set()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__set-detail)** — PHP setter 魔術方法 *(定義於 CActiveRecord)*
- **[`__sleep()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__sleep-detail)** — PHP 序列化魔術方法 *(定義於 CActiveRecord)*
- **[`__unset()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#__unset-detail)** — 將元件屬性設為 null *(定義於 CActiveRecord)*
- [`addError()`](https://www.yiiframework.com/doc/api/1.1/CModel#addError-detail) — 為指定屬性新增一筆驗證錯誤 *(定義於 CModel)*
- [`addErrors()`](https://www.yiiframework.com/doc/api/1.1/CModel#addErrors-detail) — 新增多筆驗證錯誤 *(定義於 CModel)*
- **[`addRelatedRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#addRelatedRecord-detail)** — **請勿呼叫**；[CActiveFinder](https://www.yiiframework.com/doc/api/1.1/CActiveFinder) 內部使用 *(定義於 CActiveRecord)*
- **[`afterFindInternal()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterFindInternal-detail)** — 內部呼叫 [afterFind](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterFind) *(定義於 CActiveRecord)*
- **[`applyScopes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#applyScopes-detail)** — 將查詢 scope 套用到指定條件 *(定義於 CActiveRecord)*
- [`asa()`](https://www.yiiframework.com/doc/api/1.1/CComponent#asa-detail) — 回傳具名行為（behavior）物件 *(定義於 CComponent)*
- [`attachBehavior()`](https://www.yiiframework.com/doc/api/1.1/CComponent#attachBehavior-detail) — 附加行為到此元件 *(定義於 CComponent)*
- [`attachBehaviors()`](https://www.yiiframework.com/doc/api/1.1/CComponent#attachBehaviors-detail) — 附加多個行為 *(定義於 CComponent)*
- [`attachEventHandler()`](https://www.yiiframework.com/doc/api/1.1/CComponent#attachEventHandler-detail) — 為事件附加處理常式 *(定義於 CComponent)*
- [`attributeLabels()`](https://www.yiiframework.com/doc/api/1.1/CModel#attributeLabels-detail) — 回傳屬性標籤定義 *(定義於 CModel)*
- **[`attributeNames()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#attributeNames-detail)** — 回傳所有屬性名稱 *(定義於 CActiveRecord)*
- **[`beforeFindInternal()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeFindInternal-detail)** — 內部呼叫 [beforeFind](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeFind) *(定義於 CActiveRecord)*
- [`behaviors()`](https://www.yiiframework.com/doc/api/1.1/CModel#behaviors-detail) — 回傳模型應使用的行為清單 *(定義於 CModel)*
- **[`cache()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#cache-detail)** — 設定查詢快取參數 *(定義於 CActiveRecord)*
- [`canGetProperty()`](https://www.yiiframework.com/doc/api/1.1/CComponent#canGetProperty-detail) — 判斷屬性是否可讀 *(定義於 CComponent)*
- [`canSetProperty()`](https://www.yiiframework.com/doc/api/1.1/CComponent#canSetProperty-detail) — 判斷屬性是否可寫 *(定義於 CComponent)*
- [`clearErrors()`](https://www.yiiframework.com/doc/api/1.1/CModel#clearErrors-detail) — 清除全部或單一屬性的錯誤 *(定義於 CModel)*
- **[`count()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#count-detail)** — 統計符合條件的資料列筆數 *(定義於 CActiveRecord)*
- **[`countByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#countByAttributes-detail)** — 依屬性值統計筆數 *(定義於 CActiveRecord)*
- **[`countBySql()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#countBySql-detail)** — 以 SQL 統計筆數 *(定義於 CActiveRecord)*
- [`createValidators()`](https://www.yiiframework.com/doc/api/1.1/CModel#createValidators-detail) — 依 [rules](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#rules) 建立驗證器物件 *(定義於 CModel)*
- **[`defaultScope()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#defaultScope-detail)** — 回傳預設命名 scope *(定義於 CActiveRecord)*
- **[`delete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#delete-detail)** — 刪除此記錄對應的資料列 *(定義於 CActiveRecord)*
- **[`deleteAll()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#deleteAll-detail)** — 依條件批次刪除 *(定義於 CActiveRecord)*
- **[`deleteAllByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#deleteAllByAttributes-detail)** — 依屬性值批次刪除 *(定義於 CActiveRecord)*
- **[`deleteByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#deleteByPk-detail)** — 依主鍵刪除 *(定義於 CActiveRecord)*
- [`detachBehavior()`](https://www.yiiframework.com/doc/api/1.1/CComponent#detachBehavior-detail) — 卸除行為 *(定義於 CComponent)*
- [`detachBehaviors()`](https://www.yiiframework.com/doc/api/1.1/CComponent#detachBehaviors-detail) — 卸除所有行為 *(定義於 CComponent)*
- [`detachEventHandler()`](https://www.yiiframework.com/doc/api/1.1/CComponent#detachEventHandler-detail) — 卸除事件處理常式 *(定義於 CComponent)*
- [`disableBehavior()`](https://www.yiiframework.com/doc/api/1.1/CComponent#disableBehavior-detail) — 停用指定行為 *(定義於 CComponent)*
- [`disableBehaviors()`](https://www.yiiframework.com/doc/api/1.1/CComponent#disableBehaviors-detail) — 停用所有行為 *(定義於 CComponent)*
- [`enableBehavior()`](https://www.yiiframework.com/doc/api/1.1/CComponent#enableBehavior-detail) — 啟用指定行為 *(定義於 CComponent)*
- [`enableBehaviors()`](https://www.yiiframework.com/doc/api/1.1/CComponent#enableBehaviors-detail) — 啟用所有行為 *(定義於 CComponent)*
- **[`equals()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#equals-detail)** — 比較兩筆 AR 是否相同 *(定義於 CActiveRecord)*
- [`evaluateExpression()`](https://www.yiiframework.com/doc/api/1.1/CComponent#evaluateExpression-detail) — 在此元件情境下執行 PHP 運算式或回呼 *(定義於 CComponent)*
- **[`exists()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#exists-detail)** — 檢查是否存在符合條件的資料列 *(定義於 CActiveRecord)*
- **[`find()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#find-detail)** — 查詢單筆記錄 *(定義於 CActiveRecord)*
- **[`findAll()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAll-detail)** — 查詢多筆記錄 *(定義於 CActiveRecord)*
- **[`findAllByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAllByAttributes-detail)** — 依屬性值查詢多筆 *(定義於 CActiveRecord)*
- **[`findAllByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAllByPk-detail)** — 依主鍵查詢多筆 *(定義於 CActiveRecord)*
- **[`findAllBySql()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findAllBySql-detail)** — 以 SQL 查詢多筆 *(定義於 CActiveRecord)*
- **[`findByAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findByAttributes-detail)** — 依屬性值查詢單筆 *(定義於 CActiveRecord)*
- **[`findByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findByPk-detail)** — 依主鍵查詢單筆 *(定義於 CActiveRecord)*
- **[`findBySql()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#findBySql-detail)** — 以 SQL 查詢單筆 *(定義於 CActiveRecord)*
- [`generateAttributeLabel()`](https://www.yiiframework.com/doc/api/1.1/CModel#generateAttributeLabel-detail) — 產生易讀的屬性標籤 *(定義於 CModel)*
- **[`getActiveFinder()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getActiveFinder-detail)** — 依 `with` 選項建立 Active Finder *(定義於 CActiveRecord)*
- **[`getActiveRelation()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getActiveRelation-detail)** — 回傳具名關聯宣告 *(定義於 CActiveRecord)*
- **[`getAttribute()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getAttribute-detail)** — 回傳指定屬性值 *(定義於 CActiveRecord)*
- **[`getAttributeLabel()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getAttributeLabel-detail)** — 回傳屬性顯示標籤 *(定義於 CActiveRecord)*
- **[`getAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getAttributes-detail)** — 回傳所有資料欄位屬性值 *(定義於 CActiveRecord)*
- **[`getCommandBuilder()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getCommandBuilder-detail)** — 回傳指令建構器 *(定義於 CActiveRecord)*
- **[`getDbConnection()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getDbConnection-detail)** — 回傳資料庫連線 *(定義於 CActiveRecord)*
- **[`getDbCriteria()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getDbCriteria-detail)** — 回傳查詢條件 *(定義於 CActiveRecord)*
- [`getError()`](https://www.yiiframework.com/doc/api/1.1/CModel#getError-detail) — 回傳指定屬性的第一筆錯誤 *(定義於 CModel)*
- [`getErrors()`](https://www.yiiframework.com/doc/api/1.1/CModel#getErrors-detail) — 回傳全部或單一屬性的錯誤 *(定義於 CModel)*
- [`getEventHandlers()`](https://www.yiiframework.com/doc/api/1.1/CComponent#getEventHandlers-detail) — 回傳事件已附加的處理常式清單 *(定義於 CComponent)*
- **[`getIsNewRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getIsNewRecord-detail)** — 回傳是否為新記錄 *(定義於 CActiveRecord)*
- [`getIterator()`](https://www.yiiframework.com/doc/api/1.1/CModel#getIterator-detail) — 回傳遍歷屬性的迭代器 *(定義於 CModel)*
- **[`getMetaData()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getMetaData-detail)** — 回傳 AR 中繼資料 *(定義於 CActiveRecord)*
- **[`getOldPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getOldPrimaryKey-detail)** — 回傳舊主鍵值 *(定義於 CActiveRecord)*
- **[`getPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getPrimaryKey-detail)** — 回傳主鍵值 *(定義於 CActiveRecord)*
- **[`getRelated()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getRelated-detail)** — 回傳關聯記錄 *(定義於 CActiveRecord)*
- [`getSafeAttributeNames()`](https://www.yiiframework.com/doc/api/1.1/CModel#getSafeAttributeNames-detail) — 回傳可安全大量指派的屬性名稱 *(定義於 CModel)*
- [`getScenario()`](https://www.yiiframework.com/doc/api/1.1/CModel#getScenario-detail) — 回傳目前 scenario *(定義於 CModel)*
- **[`getTableAlias()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getTableAlias-detail)** — 回傳資料表別名 *(定義於 CActiveRecord)*
- **[`getTableSchema()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#getTableSchema-detail)** — 回傳資料表結構中繼資料 *(定義於 CActiveRecord)*
- [`getValidatorList()`](https://www.yiiframework.com/doc/api/1.1/CModel#getValidatorList-detail) — 回傳所有已宣告的驗證器 *(定義於 CModel)*
- [`getValidators()`](https://www.yiiframework.com/doc/api/1.1/CModel#getValidators-detail) — 回傳目前 [scenario](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#scenario) 適用的驗證器 *(定義於 CModel)*
- **[`hasAttribute()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#hasAttribute-detail)** — 檢查是否具有指定屬性 *(定義於 CActiveRecord)*
- [`hasErrors()`](https://www.yiiframework.com/doc/api/1.1/CModel#hasErrors-detail) — 回傳是否有驗證錯誤 *(定義於 CModel)*
- [`hasEvent()`](https://www.yiiframework.com/doc/api/1.1/CComponent#hasEvent-detail) — 判斷事件是否已定義 *(定義於 CComponent)*
- [`hasEventHandler()`](https://www.yiiframework.com/doc/api/1.1/CComponent#hasEventHandler-detail) — 檢查事件是否已附加處理常式 *(定義於 CComponent)*
- [`hasProperty()`](https://www.yiiframework.com/doc/api/1.1/CComponent#hasProperty-detail) — 判斷屬性是否已定義 *(定義於 CComponent)*
- **[`hasRelated()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#hasRelated-detail)** — 回傳關聯是否已載入 *(定義於 CActiveRecord)*
- **[`init()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#init-detail)** — 初始化模型 *(定義於 CActiveRecord)*
- **[`insert()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#insert-detail)** — 新增一筆資料列 *(定義於 CActiveRecord)*
- [`isAttributeRequired()`](https://www.yiiframework.com/doc/api/1.1/CModel#isAttributeRequired-detail) — 回傳屬性是否為必填 *(定義於 CModel)*
- [`isAttributeSafe()`](https://www.yiiframework.com/doc/api/1.1/CModel#isAttributeSafe-detail) — 回傳屬性是否可安全大量指派 *(定義於 CModel)*
- **[`model()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#model-detail)** — 回傳 AR 靜態模型實例 *(定義於 CActiveRecord)*
- **[`offsetExists()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#offsetExists-detail)** — 檢查偏移位置是否有元素 *(定義於 CActiveRecord)*
- [`offsetGet()`](https://www.yiiframework.com/doc/api/1.1/CModel#offsetGet-detail) — 取得指定偏移的元素 *(定義於 CModel)*
- [`offsetSet()`](https://www.yiiframework.com/doc/api/1.1/CModel#offsetSet-detail) — 設定指定偏移的元素 *(定義於 CModel)*
- [`offsetUnset()`](https://www.yiiframework.com/doc/api/1.1/CModel#offsetUnset-detail) — 取消設定指定偏移的元素 *(定義於 CModel)*
- [`onAfterConstruct()`](https://www.yiiframework.com/doc/api/1.1/CModel#onAfterConstruct-detail) — 以 `new` 建立模型實例後觸發的事件 *(定義於 CModel)*
- **[`onAfterDelete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterDelete-detail)** — 刪除記錄後觸發的事件 *(定義於 CActiveRecord)*
- **[`onAfterFind()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterFind-detail)** — find 建立實例後觸發的事件 *(定義於 CActiveRecord)*
- **[`onAfterSave()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterSave-detail)** — 儲存記錄後觸發的事件 *(定義於 CActiveRecord)*
- [`onAfterValidate()`](https://www.yiiframework.com/doc/api/1.1/CModel#onAfterValidate-detail) — 驗證完成後觸發的事件 *(定義於 CModel)*
- **[`onBeforeCount()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeCount-detail)** — count 執行前觸發的事件 *(定義於 CActiveRecord)*
- **[`onBeforeDelete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeDelete-detail)** — 刪除記錄前觸發的事件 *(定義於 CActiveRecord)*
- **[`onBeforeFind()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeFind-detail)** — find 執行前觸發的事件 *(定義於 CActiveRecord)*
- **[`onBeforeSave()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeSave-detail)** — 儲存記錄前觸發的事件 *(定義於 CActiveRecord)*
- [`onBeforeValidate()`](https://www.yiiframework.com/doc/api/1.1/CModel#onBeforeValidate-detail) — 驗證執行前觸發的事件 *(定義於 CModel)*
- [`onUnsafeAttribute()`](https://www.yiiframework.com/doc/api/1.1/CModel#onUnsafeAttribute-detail) — 對不安全屬性進行大量指派時觸發 *(定義於 CModel)*
- **[`populateRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#populateRecord-detail)** — 依屬性建立 AR 實例 *(定義於 CActiveRecord)*
- **[`populateRecords()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#populateRecords-detail)** — 依輸入資料建立 AR 清單 *(定義於 CActiveRecord)*
- **[`primaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#primaryKey-detail)** — 回傳資料表主鍵欄位定義 *(定義於 CActiveRecord)*
- [`raiseEvent()`](https://www.yiiframework.com/doc/api/1.1/CComponent#raiseEvent-detail) — 觸發事件 *(定義於 CComponent)*
- **[`refresh()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#refresh-detail)** — 從資料庫重新載入最新資料 *(定義於 CActiveRecord)*
- **[`refreshMetaData()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#refreshMetaData-detail)** — 重新整理 AR 類別中繼資料 *(定義於 CActiveRecord)*
- **[`relations()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#relations-detail)** — 宣告關聯（須覆寫） *(定義於 CActiveRecord)*
- **[`resetScope()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#resetScope-detail)** — 重設 scope 與查詢條件 *(定義於 CActiveRecord)*
- [`rules()`](https://www.yiiframework.com/doc/api/1.1/CModel#rules-detail) — 回傳屬性驗證規則 *(定義於 CModel)*
- **[`save()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#save-detail)** — 儲存目前記錄 *(定義於 CActiveRecord)*
- **[`saveAttributes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#saveAttributes-detail)** — 僅儲存指定屬性 *(定義於 CActiveRecord)*
- **[`saveCounters()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#saveCounters-detail)** — 儲存計數器欄位 *(定義於 CActiveRecord)*
- **[`scopes()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#scopes-detail)** — 回傳命名 scope 宣告 *(定義於 CActiveRecord)*
- **[`setAttribute()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setAttribute-detail)** — 設定指定屬性值 *(定義於 CActiveRecord)*
- [`setAttributes()`](https://www.yiiframework.com/doc/api/1.1/CModel#setAttributes-detail) — 大量指派屬性值 *(定義於 CModel)*
- **[`setDbCriteria()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setDbCriteria-detail)** — 設定查詢條件 *(定義於 CActiveRecord)*
- **[`setIsNewRecord()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setIsNewRecord-detail)** — 設定是否為新記錄 *(定義於 CActiveRecord)*
- **[`setOldPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setOldPrimaryKey-detail)** — 設定舊主鍵值 *(定義於 CActiveRecord)*
- **[`setPrimaryKey()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setPrimaryKey-detail)** — 設定主鍵值 *(定義於 CActiveRecord)*
- [`setScenario()`](https://www.yiiframework.com/doc/api/1.1/CModel#setScenario-detail) — 設定 scenario *(定義於 CModel)*
- **[`setTableAlias()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#setTableAlias-detail)** — 設定資料表別名 *(定義於 CActiveRecord)*
- **[`tableName()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#tableName-detail)** — 回傳資料表名稱 *(定義於 CActiveRecord)*
- **[`together()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#together-detail)** — 將 [CDbCriteria::together](https://www.yiiframework.com/doc/api/1.1/CDbCriteria#together) 設為 true *(定義於 CActiveRecord)*
- [`unsetAttributes()`](https://www.yiiframework.com/doc/api/1.1/CModel#unsetAttributes-detail) — 將屬性設為 null *(定義於 CModel)*
- **[`update()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#update-detail)** — 更新此記錄 *(定義於 CActiveRecord)*
- **[`updateAll()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#updateAll-detail)** — 依條件批次更新 *(定義於 CActiveRecord)*
- **[`updateByPk()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#updateByPk-detail)** — 依主鍵批次更新 *(定義於 CActiveRecord)*
- **[`updateCounters()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#updateCounters-detail)** — 更新計數器欄位 *(定義於 CActiveRecord)*
- [`validate()`](https://www.yiiframework.com/doc/api/1.1/CModel#validate-detail) — 執行驗證 *(定義於 CModel)*
- **[`with()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#with-detail)** — 指定預先載入的關聯 *(定義於 CActiveRecord)*

---

## 受保護方法 (Protected Methods)

可於子類別覆寫（override）。

- [`afterConstruct()`](https://www.yiiframework.com/doc/api/1.1/CModel#afterConstruct-detail) — 以 `new` 建立模型實例後呼叫 *(定義於 CModel)*
- **[`afterDelete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterDelete-detail)** — 刪除記錄後呼叫 *(定義於 CActiveRecord)*
- **[`afterFind()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterFind-detail)** — 每筆記錄被 find 建立後呼叫 *(定義於 CActiveRecord)*
- **[`afterSave()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#afterSave-detail)** — 成功儲存記錄後呼叫 *(定義於 CActiveRecord)*
- [`afterValidate()`](https://www.yiiframework.com/doc/api/1.1/CModel#afterValidate-detail) — 驗證結束後呼叫 *(定義於 CModel)*
- **[`beforeCount()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeCount-detail)** — AR 執行 count 前呼叫 *(定義於 CActiveRecord)*
- **[`beforeDelete()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeDelete-detail)** — 刪除記錄前呼叫 *(定義於 CActiveRecord)*
- **[`beforeFind()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeFind-detail)** — AR 執行 find 前呼叫 *(定義於 CActiveRecord)*
- **[`beforeSave()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#beforeSave-detail)** — 儲存記錄前呼叫（驗證通過後） *(定義於 CActiveRecord)*
- [`beforeValidate()`](https://www.yiiframework.com/doc/api/1.1/CModel#beforeValidate-detail) — 驗證開始前呼叫 *(定義於 CModel)*
- **[`instantiate()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#instantiate-detail)** — 建立 AR 實例 *(定義於 CActiveRecord)*
- **[`query()`](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#query-detail)** — 執行實際 DB 查詢並填入 AR 物件 *(定義於 CActiveRecord)*

---

## 事件 (Events)

| 事件 | 說明 | 定義於 |
| --- | --- | --- |
| **[onBeforeSave](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeSave-detail)** | 儲存記錄前觸發 | CActiveRecord |
| **[onAfterSave](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterSave-detail)** | 儲存記錄後觸發 | CActiveRecord |
| **[onBeforeDelete](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeDelete-detail)** | 刪除記錄前觸發 | CActiveRecord |
| **[onAfterDelete](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterDelete-detail)** | 刪除記錄後觸發 | CActiveRecord |
| **[onBeforeFind](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeFind-detail)** | AR 執行 find 前觸發 | CActiveRecord |
| **[onAfterFind](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onAfterFind-detail)** | find 建立實例後觸發 | CActiveRecord |
| **[onBeforeCount](https://www.yiiframework.com/doc/api/1.1/CActiveRecord#onBeforeCount-detail)** | AR 執行 count 前觸發 | CActiveRecord |
| [onAfterConstruct](https://www.yiiframework.com/doc/api/1.1/CModel#onAfterConstruct-detail) | 以 `new` 建立模型後觸發 | CModel |
| [onBeforeValidate](https://www.yiiframework.com/doc/api/1.1/CModel#onBeforeValidate-detail) | 驗證執行前觸發 | CModel |
| [onAfterValidate](https://www.yiiframework.com/doc/api/1.1/CModel#onAfterValidate-detail) | 驗證完成後觸發 | CModel |
| [onUnsafeAttribute](https://www.yiiframework.com/doc/api/1.1/CModel#onUnsafeAttribute-detail) | 對不安全屬性大量指派時觸發 | CModel |

### 事件 ↔ 覆寫方法對照

| 事件（註冊用） | 子類別可覆寫方法 |
| --- | --- |
| `onBeforeSave` | `beforeSave()` |
| `onAfterSave` | `afterSave()` |
| `onBeforeDelete` | `beforeDelete()` |
| `onAfterDelete` | `afterDelete()` |
| `onBeforeFind` | `beforeFind()` |
| `onAfterFind` | `afterFind()` |
| `onBeforeCount` | `beforeCount()` |

---

*由官方 API 頁整理為中文版速查；參數、回傳型別與程式範例請點各方法連結至官方文件。*
