TCustomAureliusDataset.SetSourceCriteria Method
Overloads
- TCustomAureliusDataset.SetSourceCriteria(TCriteria)
- TCustomAureliusDataset.SetSourceCriteria(TCriteria, Integer)
TCustomAureliusDataset.SetSourceCriteria(TCriteria)
Executes the given criteria query and uses the result as the dataset source, fetching all records at once.
Syntax
Unit: Aurelius.Bind.Dataset
procedure TCustomAureliusDataset.SetSourceCriteria(Criteria: TCriteria); overload;
Parameters
| <-> | Parameter | Type | Description |
|---|---|---|---|
| Criteria | TCriteria | The query to execute. Ownership is transferred to the dataset, which destroys the criteria when the dataset is closed. |
See also
TCustomAureliusDataset.SetSourceCriteria(TCriteria, Integer)
Sets the given criteria query as the dataset source with paged fetch-on-demand.
Remarks
This approach provides offline fetch-on-demand: no persistent connection is held between pages, but each page requires a new database query. Use RecordCountMode to control how the total record count is reported.
Syntax
Unit: Aurelius.Bind.Dataset
procedure TCustomAureliusDataset.SetSourceCriteria(Criteria: TCriteria; PageSize: Integer); overload;
Parameters
| <-> | Parameter | Type | Description |
|---|---|---|---|
| Criteria | TCriteria | The query that defines which records to fetch. Ownership is transferred to the dataset. |
|
| PageSize | Integer | The number of records to retrieve per database round trip. When the dataset needs more records (e.g., when scrolling), it re-executes the query with the next page offset. Pass 0 to fetch all records in a single query. |