API:IBX.IBCustomDataSet.TIBCustomDataSet.Locate

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

Delphi

function Locate(const KeyFields: string; const KeyValues: Variant;  Options: TLocateOptions): Boolean; override;

C++

virtual bool __fastcall Locate(const System::UnicodeString KeyFields, const System::Variant &KeyValues, Data::Db::TLocateOptions Options);

プロパティ

種類 可視性 ソース ユニット
function public
IBX.IBCustomDataSet.pas
IBX.IBCustomDataSet.hpp
IBX.IBCustomDataSet TIBCustomDataSet

説明

指定したレコードをデータセット内で検索し,そのレコードをアクティブレコードにする仮想メソッドです。

IBX.IBCustomDataSet.TIBCustomDataSet.Locate は Data.DB.TDataSet.Locate を継承しています。以下の内容はすべて Data.DB.TDataSet.Locate を参照しています。

指定したレコードをデータセット内で検索し,そのレコードをアクティブレコードにする仮想メソッドです。

This 関数:

データセットが単方向かどうかを調べて,単方向の場合には EDatabaseError 例外を生成します。

false を返します。これは,マッチするレコードが検出されず,アクティブレコードが変更されなかったことを示します。

単方向でない下位クラスはこのメソッドをオーバーライドして,カンマで区切られた文字列 KeyFields によって識別される項目が,バリアントまたはバリアント配列 KeyValues によって指定される値を持つレコードに移動するようにすることができます。Options は大文字と小文字を区別して検索を行うかどうか,部分一致をサポートするかどうかを示します。Locate は,指定した基準にマッチするレコードが検出され,そのレコードが現在アクティブである場合に,true を返します。

関連項目