Datasnap.Provider.TProviderOption
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. |