API DataProvider
L'API DataProvider est un jeu de méthodes et de propriétés que doit posséder une source de données pour qu'une classe basée sur des listes puisse communiquer avec elle. Arrays, RecordSets et DataSet implémentent tous cette API. Vous pouvez créer une classe compatible DataProvider en implémentant toutes les méthodes et propriétés présentées dans cette section. Un composant basé sur des listes peut ensuite utiliser cette classe comme fournisseur de données.
|
REMARQUE |
|
L'API DataProvider est prise en charge uniquement si vous travaillez dans un document spécifiant ActionScript 2.0 dans ses paramètres de publication. |
Classe DataProvider
Nom de classe ActionScript mx.controls.listclasses.DataProvider
Les méthodes de la classe DataProvider vous permettent d'interroger et de modifier les données de tout composant qui affiche des données (également appelé affichage). L'API DataProvider diffuse également des événements change lorsque les données sont modifiées. Plusieurs affichages peuvent utiliser le même fournisseur de données et recevoir les événements change.
Un fournisseur de données est une série linéaire (comme un tableau) d'éléments. Chaque élément est un objet composé de plusieurs champs de données. Vous pouvez accéder à ces éléments par leur index (comme dans un tableau), en utilisant DataProvider.getItemAt().
Les fournisseurs de données sont généralement utilisés avec des tableaux. Les composants de données appliquent toutes les méthodes de l'API DataProvider à Array.prototype lorsqu'un objet Array se trouve dans la même image ou le même écran qu'un composant de données. Cela vous permet d'utiliser tout tableau existant en tant que données pour les affichages qui ont une propriété dataProvider.
Grâce à l'API DataProvider, les composants qui permettent l'affichage de données (DataGrid, List, Tree, etc.) peuvent également afficher des objets Flash Remoting RecordSet et des données du composant DataSet. L'API DataProvider est le langage qu'utilisent les composants de données pour communiquer avec leurs fournisseurs de données.
Dans la documentation d'Adobe Flash, « DataProvider » correspond au nom de la classe, dataProvider à une propriété de n'importe quel composant se comportant comme une vue pour les données, et « fournisseur de données », au terme générique utilisé pour désigner une source de données.
Méthodes de l'API DataProvider
Le tableau suivant présente les méthodes de l'API DataProvider.
|
Méthode |
Description |
|---|---|
|
Ajoute un élément à la fin du fournisseur de données. |
|
|
Ajoute un élément au fournisseur de données à l'emplacement spécifié. |
|
|
Modifie un champ du fournisseur de données. |
|
|
Obtient les données en vue d'une modification à partir d'un fournisseur de données. |
|
|
Obtient une référence à l'élément à l'emplacement spécifié. |
|
|
Renvoie l'ID unique de l'élément. |
|
|
Supprime tous les éléments du fournisseur de données. |
|
|
Supprime un élément du fournisseur de données à l'emplacement spécifié. |
|
|
Remplace l'élément par un autre à l'emplacement spécifié. |
|
|
Trie les éléments du fournisseur de données via la fonction de comparaison ou les options de tri spécifiées. |
|
|
Trie les éléments du fournisseur de données par ordre alphabétique ou numérique, dans l'ordre spécifié et selon le critère du nom de champ spécifié. |
Propriétés de l'API DataProvider
Le tableau suivant présente les propriétés de l'API DataProvider.
|
Propriété |
Description |
|---|---|
|
Nombre d'éléments dans un fournisseur de données. |
Evénements de l'API DataProvider
Le tableau suivant présente les événements de l'API DataProvider.
|
Evénement |
Description |
|---|---|
|
Diffusé lorsque le fournisseur de données est modifié. |