Re: Using Tdataset.locate with multiple fields
Posted by webmaster Guido
In Reply to: Using Tdataset.locate with multiple fields
: I tried to use locate for multiple fields in that way as the help of delphi says:
contents of your variable DF is wrong? From what I see, you should specify
Let's start with a short refresher for the other readers, so that they know what we are talking about.
Locate is used to search a dataset for a record that corresponds to certain conditions. It returns True if it finds
a matching record,
and it makes that record the "current" record. Otherwise it returns False.
function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean;
KeyFields is a string, containing one field name or several field names separated by semicolons.
Suppose that we have a dataset with the following fields:
id - alfanumeric - size 2 code - alfanumeric - size 2 size - integer
KeyFields could be 'id' or 'id;code' or 'id;code;size'.
KeyValues is a "variant" or a "variant array", containing the value(s) to search for. A variant can be of any type: string, integer, boolean,...
If there is only one field in KeyFields, then KeyValues simply contains the value to search for. Examples:
Found := Product.Locate('id', '12', ); Found := Product.Locate('size', 3, );
If there are several fields in KeyFields, then KeyValues should be a "variant array". It is allowed to construct that variant array "on the fly" using the VarArrayOf function. Example:
Product.Locate('id;code', VarArrayOf(['12', 'AB']), );
Options is a "set" that optionally specifies additional search conditions when your condition contains
one or more *string* fields:
Found := Product.Locate('id', '2', [loPartialKey]);
To search for products with a 'code' starting with 'a' or 'A':
Found := Product.Locate('code', 'a', [loCaseInsensitive, loPartialKey]);