DBAdapt.TDataSetAdapter
Contents |
Delphi-Informationen
von DBAdapt.pas
TDataSetAdapter = class(TCustomDataSetAdapter)
Unit: DBAdapt
Typ: Klasse
Geerbte Klassen-Member: Member von DBAdapt.TDataSetAdapter
C++-Informationen
von DBAdapt.hpp
TDataSetAdapter = class(TCustomDataSetAdapter)
Unit: DBAdapt
Typ: Klasse
Geerbte Klassen-Member: Member von DBAdapt.TDataSetAdapter
Klassenkonstruktoren und -destruktoren: Konstruktoren von DBAdapt.TDataSetAdapter
Beschreibung
TDataSetAdapter wird verwendet, um ein skriptfähiges Interface für eine TDataSet-Komponente zu definieren und der Datenmenge das Arbeiten in einer statuslosen Umgebung zu ermöglichen.
Verwenden Sie TDataSetAdapter ebenso wie TAdapter, um ein benutzerdefiniertes Interface für eine Anwendungslogik zu definieren. (Eine allgemeine Beschreibung von Adapter finden Sie bei "TAdapter".) Sie können TDataSetAdapter-Objekten Adapterfeldkomponenten hinzufügen und dadurch definieren, auf welche Datenmengenfelder durch ein Skript zugegriffen werden kann. Mit den Eigenschaften der Adapterfelder können weitere Metadaten der Datenmengenfelder bereitgestellt werden. Die Eigenschaft ValuesList definiert beispielsweise Namens-/Wertepaare, die für HTML-Elemente zur Bearbeitung des Feldes (z. B. Auswahllisten und Optionsfelder) verwendet werden können. Wenn Sie keine Adapterfelder hinzufügen, werden automatisch alle Adapterfelder für die unterstützten Datenmengenfeldtypen verwendet. Diese Standardfelder werden nicht in der Objekthierarchie angezeigt, stehen aber in Skripts und beim Generieren eines Formulars oder einer Tabelle mit dem TAdapterPageProducer-Objekt zur Verfügung.
Durch Hinzufügen von Aktionskomponenten zu TDataSetAdapter-Objekten kann definiert werden, welche Befehle mit der Datenmenge ausgeführt werden können. In die Klasse TDataSetAdapter ist bereits die Unterstützung für Befehle wie Löschen, Nächste Zeile und Bearbeiten integriert. Wenn Sie keine Adapteraktionen hinzufügen, werden automatisch alle Aktionen verwendet. Diese Standardaktionen werden nicht in der Objekthierarchie angezeigt, stehen aber in Skripts und beim Generieren eines Formulars oder einer Tabelle mit dem TAdapterPageProducer-Objekt zur Verfügung.
TDataSetAdapter verfügt über einen Modus (Bearbeiten, Einfügen, Anzeigen und Abfragen). Dieser wirkt sich auf die Adapterfeldwerte aus, die mit Skriptanweisungen abgerufen werden. Der gewählte Modus kann auch den von der TAdapterPageProducer-Komponente generierten HTML-Code beeinflussen. Ein Formularfeld wird beispielsweise im Bearbeiten-, Einfügen- oder Abfragemodus durch ein Eingabeelement, im Anzeigemodus aber durch ein schreibgeschütztes Textelement repräsentiert. Der Modus von TDataSetAdapter wird während der Ausführung von Adapteraktionskomponenten wie TDataSetAdapterEditRowAction geändert. Er kann auch in einem Server-Skript gewechselt werden (z. B. <% Adapter.Mode = 'Edit' %>). Sie können festlegen, dass die TAdapterPageProducer-Komponente Skriptanweisungen zur Modusänderung generiert, indem Sie der Eigenschaft AdapterMode einer TAdapterFieldGroup-Komponente den entsprechenden Wert zuweisen.
TDataSetAdapter unterstützt Haupt-/Detail-Beziehungen zwischen Datenmengen. Sie müssen dazu jeder Haupt- und Detaildatenmenge eine TDataSetAdapter-Komponente zuordnen und dann die gewünschte Beziehung zwischen diesen Objekten mit der Eigenschaft MasterAdapter angeben.
In einer WebSnap-Anwendung ist nicht sichergestellt, dass aufeinander folgende Aufrufe eines Benutzers von demselben Webmodul bearbeitet werden. Die Komponente TDataSetAdapter verwaltet den Status der Datenmenge, um die Datenintegrität zu gewährleisten. Sie führt dazu Operationen wie Öffnen und Schließen der Datenmenge, Suchen von Datensätzen, Validieren von Bearbeitungen, Eintragen und Verwerfen von Änderungen und Behandeln von Exceptions durch.