| TIB_BDataset Object
Properties Methods Events |
Unit
IB_Components
Declaration
TIB_BDataset = class(TIB_Dataset)
Description
This class serves as a base to the IB_Query component.
It is constructed in such a way that a fully scrollable/updateable dataset is
obtained. The buffering of data is all on the client.
All properties and events above the TIB_Dataset class are documented here.
Please see IB_Query for more specific information about how this class is
implemented in an application.
| Introduced Public Properties |
| AsXML | This returns the XML equivalent for the entire table. |
| BookmarkSelected | Access multi-select information for the Dataset based on a Bookmark. |
| BufferSynchroFlags | This property helps maintain correct synchronization between the client buffer and the server. |
| CachedDeleteCount | The number of records in the buffer that have been deleted via CachedUpdates. |
| CachedEditCount | The number of records in the buffer that have been edited via CachedUpdates. |
| CachedInsertCount | The number of records in the buffer that have been inserted via CachedUpdates. |
| CachedUpdates | VCL compatibility. |
| CursorIsKeyFields | Used internally to tell if the CursorFields is also serving as the KeyFields. |
| FetchWholeRows | This feature is designed to allow the limitations of the buffered query to handle all types of SELECT statements. |
| Filter | VCL compatibility. |
| Filtered | VCL compatibility. |
| FilterOptions | VCL compatibility. |
| FilterPlan | Provides the ability to specify a particular plan when a dataset is prepared with Filtered=true. |
| Found | VCL compatibility. |
| IBODataset | This gives a raw pointer to the parent TDataset class that this instance is serving as an internal cursor to. |
| IncSearchKeyInt | The amount of time a before a new search string is started when the user is entering in incremental key presses. |
| IncSearchKeyString | Access to the search string generated by the IncSearchKey() method. |
| IncSearchLastTick | This keeps track of the timings when incremental searching so that it will be able to calculate the proper timeouts for automatically clearing the incremental searching criteria. |
| IncSearchSeekInt | The amount of time a matching record is sought for in 1000th of seconds. |
| IsEmpty | Property which will tell if the dataset is empty or not in the most efficient manner possible. |
| KeyLinksAutoDefine | Change the default from false to true. |
| KeySQLSelect | This is the SELECT list that is used to fetch the keys. |
| NodeList | System reference to the in-memory portion of the buffered dataset. |
| OrderingRefinePos | The character position that will begin the incremental search. |
| OrderingRefineStr | This property stores the buffer that is used by the IncSearchString() method to perform incremental searching. |
| PreparedEdits | Redeclaration of property to better suit a buffered dataset. |
| RefreshOnParamChange | This property is redeclared in order to change the default behavior of this property for buffered Datasets. |
| Selected | Access multi-select information for the Dataset based on the RowNum. |
| Introduced Public Methods |
ApplyUpdates
|
Work in progress. |
CalculateFields
|
Manually initiate the recalculation of calculated fields for the current row. |
CancelUpdates
|
Work in progress. |
| CheckRecordFilter | Calculate the fields of the row indicated. |
| ClearIncSearchString | This call will clear out the current incremental search criteria used in conjunction with the key-by-key behavior when calling the IncSearchKey() method. |
CommitUpdates
|
Work in progress. |
Create
![]() | |
DefaultDMLCacheReceivedItem
![]() | |
| DeleteBufferBookmark | This method will remove a record from the buffer in memory only. |
| DeleteBufferRowNum | This method will remove a record from the buffer in memory but not generate any SQL to delete the record from the server. |
Destroy
![]() | |
| FindFirst | VCL compatibility. |
| FindLast | VCL compatibility. |
| FindNext | VCL compatibility. |
| FindPrior | VCL compatibility. |
| FindRecord | VCL compatibility. |
FreeSErverResources
![]() | |
| IncSearchKey | Used for processing key-by-key incremental searching. |
| IncSearchString | Used to process a whole string to be searched for within the current data. |
| InsertBufferBookmark | W.I.P. |
InvalidateBookmark
|
This method will invalidate a single row from the Dataset such that if it is referred to again it will be fetched from the server again. |
| InvalidateCalculatedFields | This method will cause the entire dataset to be recalculated if it has any calculated fields declared in it. |
InvalidateRowNum
|
This method will invalidate a single row from the Dataset such that if it is referred to again it will be fetched from the server again. |
InvalidateRows
|
This method will remove all of the individual record buffers for the Dataset and leave the key buffer in tack. |
| InvalidateSQLWithCursors | By default, the internal cursors are NOT invalidated when the main SQL is invalidated. |
| Locate | Same as in TDataset |
| Lookup | Same as in TDataset |
| LookupKeyForBufferFields | This method is used to locate a record that currently exists in the buffer or if it would when all of the records for the Dataset were fetched from the server. |
| LookupKeyForFields | This method is used to locate a record that currently exists in the Dataset or if it would when all of the records for the Dataset were fetched from the server. |
| RevertRecord | Change the record back to the state it was in when the edit or insert mode was started.. |
| SeekKeyForBufferFields | This method is used to locate a record that currently exists in the buffer. |
| SelectAll | Method to force the Selected state of all rows in the dataset to true or false. |
| SelectedBookmarks | This method will populate a TStrings list with bookmarks of the selected records. |
| SelectRange | Gives control over a particular range of rows and their Selected status. |
| ToggleSelected | Method to toggle the dataset's rows Selected state. |
ValidateRows
|
This method is used to verify if all of the rows in the range specified are valid. |
| Introduced Public Events |
| OnFilterRecord | When FetchWholeRows is true this allows a client-side filter to cause records to be left out of the buffer. |
| OnMultiSelect | This event provides notification of when a multi row selection is performed. |
| OnRowSelectedChange | This property is being phased out. |
| OnRowSelectedChanged | This event provides notification of when a row's Selected status is changed. |
| OnUpdateError | VCL Compatibility. |
| OnUpdateRecord | VCL Compatibility. |