DBAdapt.TDataSetAdapter
Contents |
Informations Delphi
De DBAdapt.pas
TDataSetAdapter = class(TCustomDataSetAdapter)
Unité : DBAdapt
Type : classe
Membres de classe hérités : Membres DBAdapt.TDataSetAdapter
Informations C++
De DBAdapt.hpp
TDataSetAdapter = class(TCustomDataSetAdapter)
Unité : DBAdapt
Type : classe
Membres de classe hérités : Membres DBAdapt.TDataSetAdapter
Constructeurs et destructeurs de classe : Constructeurs DBAdapt.TDataSetAdapter
Description
TDataSetAdapter définit une interface scriptable pour un composant TDataSet et lui permet de fonctionner correctement dans un environnement sans état.
Utilisez TDataSetAdapter comme TAdapter pour définir une interface personnalisée à la logique de l'application. Voir TAdapter pour une description générale des adaptateurs. La méthode Add ajoute des composants champ adaptateur à l'objet TDataSetAdapter pour définir les champs de l'ensemble de données auxquels un script peut accéder. Définissez les propriétés des composants champ adaptateur pour augmenter les métadonnées fournies par les champs de l'ensemble de données. Par exemple, la propriété ValuesList définit des paires nom/valeur qui peuvent être utilisées afin de remplir des éléments HTML pour modifier le champ, telles que des listes de sélection et des boutons radio. Si vous n'ajoutez aucun champ adaptateur, tous les champs adaptateur pour tous les types de champs d'ensemble de données supportés sont ajoutés par défaut. Les champs adaptateur par défaut ne sont pas montrés dans la vue arborescente, mais on peut y accéder par script et ils seront utilisés lors de la génération d'une fiche ou d'une grille avec l'objet TAdapterPageProducer.
Ajoutez des composants action adaptateur à l'objet TDataSetAdapter pour définir les commandes pouvant être exécutées sur l'ensemble de données. TDataSetAdapter prend en charge des commandes telles que Suppression, Ligne suivante et Edition. Si vous n'ajoutez aucune action adaptateur, toutes les actions sont ajoutées par défaut. Les actions adaptateur par défaut ne sont pas montrées dans la vue arborescente, mais on peut y accéder par script et elles seront utilisées lors de la génération d'une fiche ou d'une grille avec l'objet TAdapterPageProducer.
L'objet TDataSetAdapter a un mode. Les valeurs de mode comprennent l'édition, l'insertion, la consultation et l'interrogation. Le mode de TDataSetAdapter affectera les valeurs du champ adaptateur récupérées par les instructions de script. Le mode peut aussi affecter l'HTML généré par le composant TAdapterPageProducer. Par exemple, un champ de fiche sera affiché en utilisant un élément de saisie en mode édition, insertion ou requête, et avec un texte en lecture seule en mode consultation. Le mode de TDataSetAdapter est modifié lors de l'exécution de composants action adaptateur comme TDataSetAdapterEditRowAction. Le mode peut aussi être modifié en utilisant un script côté serveur (par exemple, <% Adapter.Mode = ‘Edit’ %>). Pour que l'objet TAdapterPageProducer génère un script pour modifier le mode, changez la propriété AdapterMode d'un composant TAdapterFieldGroup.
TDataSetAdapter gère les relations maître/détail entre les ensembles de données. Vous devez associer un objet TDataSetAdapter avec chaque ensemble de données maître et détail et utiliser la propriété MasterAdapter pour indiquer la relation maître/détail entre les composants TDataSetAdapter.
Dans une application WepSnap, il n'y a aucune garantie que le même module Web soit utilisé pour servir des requêtes consécutives émanant du même utilisateur. L'objet TDataSetAdapter gère l'état du composant ensemble de données pour garantir l'intégrité des données. L'ouverture et la fermeture de l'ensemble de données, la localisation des enregistrements, la validation des modifications, l'expédition des changements, leur annulation et la gestion des exceptions sont de la responsabilité de TDataSetAdapter.