Datasnap.DBClient.TCustomClientDataSet.FindNearest

提供: RAD Studio API Documentation
移動先: 案内検索

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 は、文字列データ型に対してのみ、動作します。

関連項目

コード サンプル