Skip to main content
Table of Contents

TTMSFNCCustomDataGridDatabaseAdapter.DataSetLocate Method

Moves the linked dataset to the first record that matches the given key values.

API unit family: TMSFNCDataGridDatabaseAdapter Declaring type: TTMSFNCCustomDataGridDatabaseAdapter

Syntax

FMX.TMSFNCDataGridDatabaseAdapter.hppPascalC++
function DataSetLocate(AKeyFieldNames: string; AKeyValues: string): Boolean;
bool __fastcall DataSetLocate(System::UnicodeString AKeyFieldNames, System::UnicodeString AKeyValues);

Remarks

Uses TDataSet.Locate without options, so the match is exact and case-sensitive. The grid follows the new position automatically.

Parameters

Name Description
AKeyFieldNames Name of the key field, or several names separated by semicolons.
AKeyValues Value to look for. Passed to TDataSet.Locate as a single value, so it suits single-field searches.

Returns

True when a matching record was found and made current; False when none matched or no open dataset is linked.