Datasnap.Provider.TProviderOption

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

TProviderOption = (poFetchBlobsOnDemand, poFetchDetailsOnDemand,
poIncFieldProps, poCascadeDeletes, poCascadeUpdates, poReadOnly,
poAllowMultiRecordUpdates, poDisableInserts, poDisableEdits,
poDisableDeletes, poNoReset, poAutoRefresh, poPropogateChanges,
poAllowCommandText, poRetainServerOrder, poUseQuoteChar );

C++

enum DECLSPEC_DENUM TProviderOption : unsigned char { poFetchBlobsOnDemand, poFetchDetailsOnDemand, poIncFieldProps, poCascadeDeletes, poCascadeUpdates, poReadOnly, poAllowMultiRecordUpdates, poDisableInserts, poDisableEdits, poDisableDeletes, poNoReset, poAutoRefresh, poPropogateChanges, poAllowCommandText, poRetainServerOrder, poUseQuoteChar };

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
enum public
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider Datasnap.Provider

Beschreibung

TProviderOption und TProviderOptions bestimmen, welche Art von Informationen zwischen Client-Datenmengen und Provider-Komponenten ausgetauscht werden.

TProviderOptions ist eine Menge von TProviderOption-Werten. Die folgende Tabelle enthält die möglichen Werte:



Wert Bedeutung

poFetchBlobsOnDemand

BLOB-Felder werden nicht in das Datenpaket aufgenommen. Sie müssen bei Bedarf von den Client-Anwendungen angefordert werden. Hat die Eigenschaft FetchOnDemand der Client-Datenmenge den Wert true, geschieht dies automatisch. Andernfalls müssen die BLOB-Daten explizit mit der Methode FetchBlobs abgerufen werden.

poFetchDetailsOnDemand

Wird die Provider-Komponente für die Haupttabelle einer Haupt-/Detailbeziehung verwendet, werden verschachtelte Detailwerte nicht in das Datenpaket aufgenommen. Die Informationen müssen bei Bedarf von den Client-Anwendungen angefordert werden. Hat die Eigenschaft FetchOnDemand der Client-Datenmenge den Wert true, geschieht dies automatisch. Andernfalls müssen die verschachtelten Detailmengen explizit mit der Methode FetchDetails abgerufen werden.

poIncFieldProps

Das Datenpaket enthält die folgenden Feldeigenschaften (sofern anwendbar): Alignment, DisplayLabel, DisplayWidth, Visible, DisplayFormat, EditFormat, MaxValue, MinValue, Currency, EditMask und DisplayValues.

poCascadeDeletes

Beim Löschen eines Datensatzes in der Haupttabelle werden automatisch auch die verknüpften Detaildatensätze gelöscht. Dieser Wert kann nur verwendet werden, wenn die Provider-Komponente die Haupttabelle einer Haupt-/Detailbeziehung darstellt und das Datenbanksystem diese Art von Löschoperationen unterstützt.

poCascadeUpdates

Beim Ändern von Schlüsselfeldern in der Haupttabelle werden automatisch auch die verknüpften Detaildatensätze aktualisiert. Dieser Wert kann nur verwendet werden, wenn die Provider-Komponente die Haupttabelle einer Haupt-/Detailbeziehung darstellt und das Datenbanksystem diese Art von Aktualisierung unterstützt.

poReadOnly

Von den Client-Datenmengen können keine Aktualisierungen an die Provider-Komponente übergeben werden.

poAllowMultiRecordUpdates

Mehrere Datensätze können in einer Operation aktualisiert werden. Wird dieser Wert nicht angegeben, werden Aktualisierungen mit mehreren Datensätzen automatisch abgebrochen.

poDisableInserts

Die Client-Anwendungen können keine neuen Datensätze hinzufügen. Versuchen sie dies dennoch, wird eine Exception ausgelöst. Die Clients können aber weiterhin Datensätze bearbeiten oder löschen.

poDisableEdits

Die Client-Anwendungen können keine vorhandenen Datensätze ändern. Versuchen sie dies dennoch, wird eine Exception ausgelöst. Die Clients können aber weiterhin Datensätze hinzufügen oder löschen.

poDisableDeletes

Die Client-Anwendungen können keine Datensätze löschen. Versuchen sie dies dennoch, wird eine Exception ausgelöst. Die Clients können aber weiterhin Datensätze bearbeiten oder hinzufügen.

poNoReset

Das Zurücksetzen-Flag (TGetRecordsOption-Wert grReset) wird in Aufrufen der Methode AS_GetRecords ignoriert.

poAutoRefresh

Die Client-Datenmenge wird beim Eintragen von Änderungen mit den aktuellen Datensatzwerten aktualisiert.

poPropogateChanges

Die in einer Ereignisbehandlungsroutine für BeforeUpdateRecord oder AfterUpdateRecord vorgenommenen Änderungen werden an den Client zurückgesendet und in die Client-Datenmenge eingefügt.

poAllowCommandText

Der Client kann die Eigenschaft CommandText der Datenmenge des Providers außer Kraft setzen, indem er die SQL-Anweisung bzw. den Namen der Stored Procedure oder Tabelle durch den gewünschten Wert ersetzt. Die neuen Anweisungen werden an die Methode GetRecords oder Execute übergeben.

poRetainServerOrder

Der Client soll nicht versuchen, die Standardreihenfolge durch Sortieren der Datensätze in dem Datenpaket wiederherzustellen. Dadurch wird verhindert, dass der Client die Reihenfolge der Datensätze ändert, weil er beispielsweise das Gebietsschema des Servers nicht duplizieren kann.

poUseQuoteChar

Das vom SQL-Provider verwendete Anführungszeichen (“) wird auch für SQL-Bezeichner in vom Provider erzeugten SQL-Abfragen verwendet. Diese Option ist standardmäßig auf True gesetzt; bei False werden die Anführungszeichen entfernt.



Siehe auch