RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCustomClientDataSet.FindKey Method

Searches for a record containing specified field values.

Pascal
function FindKey(const KeyValues: array of const): Boolean; virtual;
C++
virtual __fastcall Boolean FindKey(const array of const KeyValues);

Call FindKey to search for a specific record in a dataset. KeyValues contains a comma-delimited array of field values, called a key. Each value in the key can be a literal, a variable, nil (Delphi), or NULL (C++). If the number of values passed in KeyValues is less than the number of columns in the index used for the search, the missing values are assumed to be NULL. For C++, KeyValues_Size indicates the index of the last value in the KeyValues array. This is one less than the number of key values. 

If a search is successful, FindKey positions the cursor on the matching record and returns true. Otherwise the cursor is not moved, and FindKey returns false. 

 

FindNearest 

GotoKey 

GotoNearest 

IndexName 

IndexFieldNames 

Locate 

Executing a Search with Find Methods

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!