TCustomCachedDataSet.Options Property

Influences how data is fetched and how it can be used.

Pascal

property Options: TProviderOptions;

C++

__property TProviderOptions Options;

Description

Set Options to customize how the client dataset communicates with its internal provider. Options is a set that specifies

Whether nested detail sets and BLOB data are included in data packets or fetched separately. The internal source dataset will always fetch this information, but Options controls whether it is immediately copied into the client dataset's Data. (This can affect the performance of the dataset.) If nested details or BLOB data are not included, the FetchOnDemand property controls whether they are automatically copied into Data on an as-needed basis, or if the application must explicitly call FetchBlobs or FetchDetails.

Whether Data is read-only, and whether specific types of changes (insertions, edits, or deletions) are disabled.

Whether a single update can affect multiple server records.

Whether records are refreshed when the dataset applies updates.

Note: Options is the same as the Options property on the internal provider. However, the TProviderOptions type includes some values that are only appropriate to an external provider component. For example, poAllowCommandText should never be removed from Options, or the CommandText property will not work. The internal source dataset does not use persistent fields, so poIncFieldProps does not work. Instead of using poReadOnly, you can set the ReadOnly property.