Flash CS4 Professional ActionScript 2.0

DataProvider API

DataProvider API 是資料來源在與 List 型類別通訊時所需的方法與屬性的集合。陣列、RecordSet 資料集和 DataSet 資料集全都實作這個 API。您可以實作這部分說明的所有方法和屬性,建立與 DataProvider 相容的類別。如此,清單類型的組件就可以將該類別當做資料提供者。

注意

 

只有當您使用在「發佈設定」中指定 ActionScript 2.0 的文件時,才支援 DataProvider API。

DataProvider 類別

ActionScript 類別名稱 mx.controls.listclasses.DataProvider

DataProvider 類別的方法可讓您在任何顯示資料的組件 (也稱為「檢視」) 中查詢及修改資料。DataProvider API 也會在資料變更時傳送 change 事件。多個檢視可以使用同一個資料提供者,而且所有檢視都會接收 change 事件。

資料提供者是項目的線性集合 (如陣列)。每一個項目都是一個由許多資料欄位組成的物件。您可以利用 DataProvider.getItemAt(),透過索引來存取它們 (如同存取陣列一般)。

資料提供者大部分是用來存取陣列的。能辨識資料的組件會在 Array 物件與能辨識資料的組件位於同一個影格或畫面時,將 DataProvider API 的所有方法套用到 Array.prototype。如此您就能夠使用任何現有的陣列,當做具有 dataProvider 屬性之檢視的資料。

由於 DataProvider API 的緣故,提供資料檢視的組件 (DataGrid、List、Tree 等) 也可以從 DataSet 組件顯示 Flash Remoting RecordSet 物件和資料。DataProvider API 是能辨識資料之組件與其資料提供者通訊時使用的語言。

在 Adobe Flash 文件中,"DataProvider" 是類別的名稱,dataProvider 是每個做為資料檢視的組件的屬性,而「資料提供者」則是資料來源的通用術語。

DataProvider API 的方法摘要

下表列出 DataProvider API 的方法:

方法

說明

DataProvider.addItem()

將項目加入資料提供者結尾。

DataProvider.addItemAt()

將項目加入資料提供者中指定的位置。

DataProvider.editField()

變更資料提供者的一個欄位。

DataProvider.getEditingData()

從資料提供者取得資料,進行編輯。

DataProvider.getItemAt()

取得指定位置的項目參考。

DataProvider.getItemID()

傳回項目的唯一 ID。

DataProvider.removeAll()

移除資料提供者中的所有項目。

DataProvider.removeItemAt()

移除資料提供者中指定位置的項目。

DataProvider.replaceItemAt()

用另一個項目取代指定位置的項目。

DataProvider.sortItems()

依據比較函數或排序選項來排序資料提供者中的項目。

DataProvider.sortItemsBy()

使用指定的欄位名稱,依指定的英文字母順序或數字順序,排序資料提供者中的項目。

DataProvider API 的屬性摘要

下表列出 DataProvider API 的屬性:

屬性

說明

DataProvider.length

資料提供者中的項目數。

DataProvider API 的事件摘要

下表列出 DataProvider API 的事件:

事件

說明

DataProvider.modelChanged

在資料提供者變更時傳送。