IDataProvider
包 | system.web |
---|---|
继承 | interface IDataProvider |
子类 | CActiveDataProvider, CArrayDataProvider, CDataProvider, CSqlDataProvider |
可用自 | 1.1 |
源码 | framework/base/interfaces.php |
IDataProvider is the interface that must be implemented by data provider classes.
Data providers are components that can feed data for widgets such as data grid, data list. Besides providing data, they also support pagination and sorting.
Data providers are components that can feed data for widgets such as data grid, data list. Besides providing data, they also support pagination and sorting.
公共方法
方法 | 描述 | 被定义在 |
---|---|---|
getData() | Returns the data items currently available. | IDataProvider |
getId() | Returns the unique ID that identifies the data provider from other data providers. | IDataProvider |
getItemCount() | Returns the number of data items in the current page. | IDataProvider |
getKeys() | Returns the key values associated with the data items. | IDataProvider |
getPagination() | Returns the pagination object. If this is false, it means the pagination is disabled. | IDataProvider |
getSort() | Returns the sorting object. If this is false, it means the sorting is disabled. | IDataProvider |
getTotalItemCount() | Returns the total number of data items. | IDataProvider |
方法详情
getData()
方法
abstract public array getData(boolean $refresh=false)
| ||
$refresh | boolean | whether the data should be re-fetched from persistent storage. |
{return} | array | the list of data items currently available in this data provider. |
Returns the data items currently available.
getId()
方法
abstract public string getId()
| ||
{return} | string | the unique ID that identifies the data provider from other data providers. |
getItemCount()
方法
abstract public integer getItemCount(boolean $refresh=false)
| ||
$refresh | boolean | whether the number of data items should be re-calculated. |
{return} | integer | the number of data items in the current page. |
Returns the number of data items in the current page.
This is equivalent to count($provider->getData())
.
When pagination is set false, this returns the same value as totalItemCount.
getKeys()
方法
abstract public array getKeys(boolean $refresh=false)
| ||
$refresh | boolean | whether the keys should be re-calculated. |
{return} | array | the list of key values corresponding to data. Each data item in data is uniquely identified by the corresponding key value in this array. |
Returns the key values associated with the data items.
getPagination()
方法
abstract public CPagination getPagination()
| ||
{return} | CPagination | the pagination object. If this is false, it means the pagination is disabled. |
getSort()
方法
abstract public CSort getSort()
| ||
{return} | CSort | the sorting object. If this is false, it means the sorting is disabled. |
getTotalItemCount()
方法
abstract public integer getTotalItemCount(boolean $refresh=false)
| ||
$refresh | boolean | whether the total number of data items should be re-calculated. |
{return} | integer | total number of possible data items. |
Returns the total number of data items. When pagination is set false, this returns the same value as itemCount.