Datasnap.DBClient.TCustomClientDataSet.FindNearest
Delphi
procedure FindNearest(const KeyValues: array of const);
C++
void __fastcall FindNearest(const System::TVarRec *KeyValues, const System::NativeInt KeyValues_High);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
説明
指定されたキー値のセットに、(比較的)最も一致したレコードにカーソルを移動します。
FindNearest を呼び出すと、データセット内の特定のレコードへカーソルを移動するか、KeyValues
パラメータで指定された値と一致、またはそれより大きい最初のレコードに、カーソルを移動させます。指定された条件と一致またはそれを含むレコードがない場合、FindNearest は、カーソルをテーブルの最後のレコードに移動させます。KeyExclusive プロパティは、一致した値が検討されるかどうかを制御します。
KeyValues
は、キー、と呼ばれるフィールド値のカンマ区切りの配列です。 KeyValues
で渡された値の数が、検索で使用されるインデックス内の列の数より少なかった場合、足りない値は NULL であるとされます。 C++ では、KeyValues_Size は、KeyValues 配列内の最後の値のインデックスを示します。 これは、キー値の数よりも 1 つ少ない数です。
メモ: FindNearest は、文字列データ型に対してのみ、動作します。