Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxCustomDataSource.GetRecordId(TcxDataRecordHandle) Method

Returns a value uniquely identifying a record.

#Declaration

Delphi
function GetRecordId(ARecordHandle: TcxDataRecordHandle): Variant; virtual;

#Parameters

Name Type
ARecordHandle TcxDataRecordHandle

#Returns

Type
Variant

#Remarks

Use the GetRecordId method to obtain the unique identifier for a dataset record. The ARecordHandle parameter specifies the handle of a dataset record whose identifier is obtained.

The return value of this method is used when saving or restoring the expansion and selection state of the records (see the SaveKeys and RestoreKeys methods descriptions). The record identifiers, unlike the record handles and indexes, are not changed when the number and order of records within the data set changes (see the TcxCustomDataSource class description for information on record indexes and record handles).

Override the IsRecordIdSupported and GetRecordId methods when implementing custom datasource (provider mode of the Express DataController).

See Also